home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / dsz0416.arc / DSZ.DOC < prev    next >
Text File  |  1991-04-28  |  131KB  |  3,777 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                      CONTENTS
  7.  
  8.  
  9.       1.  TUTORIAL INTRODUCTION..........................................   2
  10.  
  11.       2.  CALLING DSZ FROM COMM PROGRAMS.................................   3
  12.           2.1    USE AN INTERFACE PROGRAM................................   3
  13.           2.2    Ms-Kermit 3.00..........................................   3
  14.           2.3    PROCOMM PLUS............................................   3
  15.           2.4    Qmodem..................................................   5
  16.           2.5    GT POWER 13.00/14.00....................................   6
  17.           2.6    TELIX...................................................   6
  18.           2.7    BULLETIN BOARDS.........................................   7
  19.  
  20.       3.  DESCRIPTION....................................................   8
  21.  
  22.       4.  COMMANDS.......................................................  10
  23.           4.1    List of Commands........................................  10
  24.           4.2    Interrupt Keys..........................................  16
  25.  
  26.       5.  NUMERIC PARAMETERS.............................................  17
  27.  
  28.       6.  ENVIRONMENT VARIABLES..........................................  20
  29.  
  30.       7.  EXIT STATUS....................................................  24
  31.  
  32.       8.  EXAMPLES.......................................................  25
  33.  
  34.       9.  BACKGROUND OPERATION...........................................  26
  35.           9.1    Windows 3...............................................  27
  36.           9.2    VM......................................................  27
  37.  
  38.      10.  FLOW CONTROL...................................................  28
  39.  
  40.      11.  ERROR MESSAGES.................................................  29
  41.           11.1   Got ZRPOS...............................................  30
  42.           11.2   Subpacket too Long......................................  31
  43.           11.3   Bad CRC.................................................  31
  44.           11.4   Serial Input Error: Line Status Register xx ............  31
  45.           11.5   No Carrier Detect.......................................  33
  46.           11.6   Port %d (%X) defective..................................  33
  47.           11.7   COMMAND NOT FOUND.......................................  33
  48.           11.8   Out of Environment......................................  34
  49.  
  50.      12.  SLOW TRANSFERS.................................................  35
  51.  
  52.      13.  IN CASE OF DIFFICULTY..........................................  36
  53.           13.1   LOCKUPS.................................................  36
  54.                  13.1.1   Insufficient Memory  36
  55.                  13.1.2   Environment TOO BIG  36
  56.                  13.1.3   Bad COM Port Configuration  36
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                  13.1.4   LAN Manager Conflicts  37
  66.           13.2   Incorrect Batch Files...................................  38
  67.           13.3   Cheap Internal Modems...................................  38
  68.           13.4   Commands Entered in Upper Case..........................  38
  69.           13.5   No Carrier Detect.......................................  38
  70.           13.6   PKARC 3.6...............................................  39
  71.           13.7   DOS 3.x.................................................  39
  72.           13.8   Perstor Controllers.....................................  39
  73.           13.9   IBM PS/2 Model 50Z......................................  39
  74.           13.10  Brain Damaged UARTS.....................................  40
  75.                  13.10.1  Everex Internal Modems  41
  76.           13.11  Weird Iron..............................................  41
  77.           13.12  Will the real YMODEM please stand up?...................  41
  78.           13.13  286 and 386 Extended Memory.............................  41
  79.           13.14  Disk Caches.............................................  42
  80.  
  81.      14.  ASSOCIATED DOCUMENTS...........................................  43
  82.  
  83.      15.  FILES..........................................................  44
  84.  
  85.      16.  Other Omen Technology Products.................................  46
  86.           16.1   Professional-YAM COMMS TOOLS............................  46
  87.           16.2   ZCOMM: Industrial Strength COMMS Shareware..............  46
  88.           16.3   ZMODEM Developer's Collection...........................  46
  89.  
  90.      17.  FAIR PLAY......................................................  47
  91.           17.1   Sharing DSZ Files.......................................  48
  92.           17.2   REGISTRATION............................................  49
  93.           17.3   Files on Registration Disk..............................  50
  94.           17.4   Bulletin Board Registration.............................  51
  95.  
  96.      18.  CHANGES........................................................  53
  97.  
  98.      19.  ACKNOWLEDGEMENTS...............................................  61
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.                                   Chuck Forsberg
  126.  
  127.                                Omen Technology Inc
  128.  
  129.  
  130.                                      ABSTRACT
  131.  
  132.  
  133.  
  134.                    ZMODEM-90(TM) - Not just another XMODEM hack
  135.  
  136.      DSZ is one of many available programs that implement the ZMODEM file
  137.      transfer protocol.
  138.  
  139.      DSZ's ZMODEM provides advanced file management features including two
  140.      levels of Intelligent Crash Recovery(TM), and flexible control of
  141.      selective file transfers.  Omen Technology's Professional-YAM
  142.      Communications Tools also provide security verified command downloading.
  143.  
  144.      The ZMODEM file transfer protocol provides reliable file and command
  145.      transfers with complete END-TO-END data integrity between application
  146.      programs.  DSZ's 32 bit CRC protects against errors that sneak by "error
  147.      free" modems and even the most advanced networks.
  148.  
  149.      ZMODEM safeguards all data and supervisory information with effective
  150.      error detection.  (XMODEM and many recently introduced protocols do not
  151.      protect vital supervisory data.)
  152.  
  153.      ZMODEM rapidly transfers files, particularly with buffered (error
  154.      correcting) modems, timesharing systems, satellite relays, and wide area
  155.      packet switched networks.  ZMODEM's streaming operation eliminates
  156.      delays caused by Kermit/XMODEM/YMODEM/JMODEM block acknowledgements.
  157.      ZMODEM eliminates the classic XMODEM/YMODEM/JMODEM PACKET LENGTH
  158.      compromises between transfer efficiency and error recovery.  ZMODEM's
  159.      packet length is the entire file.
  160.  
  161.      User Friendliness is an important ZMODEM feature.  ZMODEM AutoDownloadm
  162.      (Automatic file Download without user intervention) provides a level of
  163.      convenience unimaginable to users of traditional protocols.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.        DSZ - a ZMODEM-90(TM), True YMODEM(TM), XMODEM File Transfer Program
  179.  
  180.  
  181.                                Omen Technology Inc
  182.  
  183.  
  184.                            Omen Technology Incorporated
  185.                           The High Reliability Software
  186.  
  187.                        17505-V Northwest Sauvie Island Road
  188.                               Portland Oregon 97231
  189.                TeleGodzilla BBS: 503-621-3746 Speed 1200,2400,19200
  190.                                 FAX: 503-621-3735
  191.                          CompuServe:70007,2304  GEnie:CAF
  192.                         UUCP: ...!tektronix!reed!omen!caf
  193.  
  194.      *************************************************************************
  195.      There's something special about DSZ registration.  With most programs,
  196.      registration applies only to the current version.  DSZ isn't like that.
  197.  
  198.      DSZ registration bypasses the shareware announcement and unlocks the
  199.      advanced features in all past and future versions of DSZ.  You don't
  200.      have to pay and pay again for new versions.  Omen's Demand Upgrade(TM)
  201.      technology allows you to download and activate future DSZ versions
  202.      without further registration!
  203.      *************************************************************************
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.      Chapter 1 Pg 2        DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  238.  
  239.  
  240.      1.  TUTORIAL INTRODUCTION
  241.  
  242.      If you are just starting out with DSZ, or if you have difficulty getting
  243.      DSZ to work, please follow the procedure given below.
  244.  
  245.      Do not run any TSR or other COMM program.  This includes LAN programs.
  246.      Reboot a clean DOS if necessary.
  247.  
  248.      Start with the following command given directly from the DOS prompt:
  249.  
  250.              dsz port 1 speed 2400 d t
  251.  
  252.      Type it exactly as it appears above; do NOT use upper case.
  253.  
  254.      (Change the port number and speed as necessary.  Use only COM1 or COM2
  255.      for testing.)
  256.  
  257.      This connects you to the modem.  Dial a bulletin board by typing AT
  258.      commands to the modem ("ATDP621-3746 <enter>")[1] to make it dial the
  259.      BBS.  Log in as usual.  Then, request a ZMODEM download of a file you
  260.      don't already have.  The file will download automatically, you don't
  261.      have to do anything.  This procedure verifies the correct operation of
  262.      DSZ.
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.      __________
  287.  
  288.       1. If your modem has a non standard setting the ATDT621-3746 command
  289.          you type to the modem may not echo on the screen.
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.      Chapter 2 Pg 3        DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  297.  
  298.  
  299.      2.  CALLING DSZ FROM COMM PROGRAMS
  300.  
  301.      It may be necessary to give a
  302.  
  303.      SET COMSPEC=A:\COMMAND.COM
  304.  
  305.      (change as needed) in your AUTOEXEC.BAT file to allow programs to call
  306.      DSZ.
  307.  
  308.      Note: NO SPACES in the SET command!
  309.  
  310.      2.1  USE AN INTERFACE PROGRAM
  311.  
  312.      A number of programs have been written to interface communications
  313.      programs to DSZ.  Programs such as XFER help many users customize DSZ to
  314.      their tastes.
  315.  
  316.      Calling DSZ with these programs require more memory than calling DSZ
  317.      directly.
  318.  
  319.      2.2  Ms-Kermit 3.00
  320.  
  321.      The "push" command (^[p) in MS-Kermit 3.00 sends an XOFF character to
  322.      the modem before calling DOS.
  323.  
  324.      Using this to activate DSZ's term mode with a "dsz t" command causes
  325.      most remote hosts to stop.  The remote host can be un-wedged by
  326.      keyboarding XON (Ctrl-Q) from DSZ's terminal mode.
  327.  
  328.  
  329.      2.3  PROCOMM PLUS
  330.  
  331.      It's easy to add DSZ to ProComm Plus.
  332.  
  333.      Datastorm has not licensed ZMODEM-90(Tm despite allegations that DSZ is
  334.      now "built in" to ProComm Plus version 2.  Many users of ProComm Plus
  335.      version 2.x use DSZ to get MobyTurbo(Tm, Intelligent Crash Recovery(Tm,
  336.      and other ZMODEM-90(Tm features.
  337.  
  338.      Make sure the DSZ program is in your search path.  If you don't see DSZ
  339.      announce itself when called from ProComm, DSZ is not in your search
  340.      path.
  341.  
  342.      Here are some handy settings for ProComm Plus.
  343.  
  344.      First, you may need to set the DOS environment before running ProComm.
  345.      Give these commands to DOS before running ProComm:
  346.  
  347.      Note: NO SPACES in the SET command!
  348.      SET DSZPORT=2           (Only needed for COM2)
  349.      SET DSZLOG=DSZ.LOG      (Only if you wish a log file)
  350.  
  351.  
  352.  
  353.  
  354.  
  355.      Chapter 2 Pg 4        DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  356.  
  357.  
  358.      Then set ProComm's external protocol strings.  From terminal mode hit
  359.      ALT-S, then select the PROTOCOL OPTIONS menu item.
  360.  
  361.      From that menu select EXTERNAL PROTOCOL OPTIONS.  Then set ProComm's
  362.      external protocol strings to:
  363.      A- External protocol 1 upload filename:  ZMODEMU
  364.      B- External protocol 1 download filename: ZMODEMD
  365.      C- External protocol 2 download filename: ZMODEMMD
  366.  
  367.      The following batch files are included in the DSZ zipfile:
  368.      ZMODEMU.BAT (contains:  DSZ sz %1 %2 %3 %4 %5 %6 %7 %8 %9)
  369.      ZMODEMD.BAT (contains:   DSZ rz)
  370.      ZMODEMDR.BAT (contains:   DSZ rz -r)
  371.      ZMODEMMD.BAT (contains:   DSZ rz -mr)
  372.      ZMODEMAD.BAT (contains: DSZ t)
  373.  
  374.      !!!!IMPORTANT USE lower case (small letters) EXCEPT WHERE SHOWN!!!!
  375.  
  376.      If using ProcommPlus 2.x, select the ZMODEM PROTOCOL OPTIONS menu and
  377.      turn off Auto downloading.
  378.  
  379.      When sending (uploading) files with ZMODEMU.BAT give the ProComm window
  380.      the full pathname (c:/foo/bar/file.ext) for *each* file not residing in
  381.      the current directory.
  382.  
  383.      When downloading files with one of the other batch files shown above,
  384.      Procomm will also prompt for parameters; just hit ENTER.  Or, you can
  385.      enter options such as "-mr" if they are't included in the batch file
  386.      itself.
  387.  
  388.      Once you've got the hang of things the "ProComm way", try the "dsz t"
  389.      command described above to give you automatic ZMODEM-90(Tm downloads
  390.      (Look Ma, no keystrokes!!!)..
  391.  
  392.      You can also set the editor hot key (ALT-A) or view program hot key
  393.      (ALT-V) by using the ALT-S "FILE/PATH OPTIONS" menu.  The strings for
  394.      these keys are long enough to store an entire DSZ command line without
  395.      need for a batch file.
  396.  
  397.      COM3 and COM4 on Procomm Plus are non standard; in case of difficulty
  398.      use COM1 or COM2 or use the portx command.
  399.  
  400.      DSZ may not operate properly when called from ProComm if ProComm has
  401.      files open at the time.
  402.  
  403.      A number of reports have been received of problems running DSZ from
  404.      ProComm Plus because of insufficient memory.  Please refer to the
  405.      subchapter on LOCKUPS.
  406.  
  407.      When running under ProComm's Host mode, failure to use the DSZ CON
  408.      command may cause ProComm to lock up the computer, or at least interfere
  409.  
  410.  
  411.  
  412.  
  413.  
  414.      Chapter 2 Pg 5        DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  415.  
  416.  
  417.      with file transfers, etc.
  418.  
  419.      EXAMPLE: DSZ CON sz %1
  420.  
  421.  
  422.      A number of third party programs have been developed to provide a
  423.      congenial interface to DSZ if you have enough memory to spare.  The POE,
  424.      PCALL, DSZ_ZAP, and PROZ programs have been popular in interfacing DSZ
  425.      to ProComm's editor gateway.  These programs are available on many
  426.      bulletin boards.
  427.  
  428.      Hint: the DOS PATH environment variable must include ProComm's directory
  429.      to allow POE to locate all the POE files,.  The POE files should be
  430.      stored in the ProComm directory.  Setting the "PROCOMM" environment
  431.      variable is insufficient.
  432.  
  433.  
  434.      2.4  Qmodem
  435.  
  436.      Instability in the Qmodem interface may require changes in the batch
  437.      files depending on which version of Qmodem is used.
  438.  
  439.      If you define a protocol with 'Z' as its letter, the latest Qmodem will
  440.      detect automatic ZMODEM downloads.  Defining an external 'Z' protocol
  441.      disables Qmodem's internal ZMODEM, allowing DSZ to be called.
  442.  
  443.      The following is based on a message from Mike Cody, sysop of HomePlate
  444.      313-385-9969 3/12/24/96 HST
  445.  
  446.      Go into Qinstall and go to frame 3 Directories. Then select External
  447.      protocols #3 I think. Now you will see a definition area to tell Qmodem
  448.      the Letter,batchfile combo to use.
  449.  
  450.      Now put Z in the letter definition, Zup.bat in the u/l batch zdown.bat
  451.      in the d/l batch, and Y in the batch protocol. Now save it at the menu
  452.      with f10 and S.
  453.  
  454.      Then go to DOS and create the following batch files in your Qmodem
  455.      directory...
  456.  
  457.      zdown.bat: DSZ port %2 speed %1 rz -rr
  458.  
  459.      zmdown.bat: DSZ port %2 speed %1 rz -mrr        ((FOR MOBYTURBO!!))
  460.  
  461.      zup.bat: DSZ port %2 speed %1 sz %4
  462.  
  463.      !!!!IMPORTANT USE lower case (small letters) EXCEPT WHERE SHOWN!!!!
  464.  
  465.      These are the batch files that will be called by Qmodem.  If you did
  466.      everything right when you hit PGDN or PGUP you will see an external
  467.      protocol called Z) Zmodem in the box. For an easier time do a search for
  468.  
  469.  
  470.  
  471.  
  472.  
  473.      Chapter 2 Pg 6        DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  474.  
  475.  
  476.      either External.arc or maybe the string "Qmodem" in the file database as
  477.      there is a file with several external protocols and batch files
  478.      available in the Mahoney file section (EXEC-PC BBS).
  479.  
  480.      The following batch files for Qmodem are included in the DSZ zipfile:
  481.  
  482.      ZDOWN.BAT contains:     DSZ port %2 speed %1 rz -rr
  483.      ZUP.BAT contains:       DSZ port %2 speed %1 sz %4
  484.  
  485.      !!!!IMPORTANT USE lower case (small letters) EXCEPT WHERE SHOWN!!!!
  486.  
  487.      A variation on the receive batch file:
  488.      c:elecomqmodem
  489.                    sz.com ha slow est 0 %3 rz -mrr
  490.      A variation on the send batch file:
  491.      c:elecomqmodemsz.com ha cts est 0 %3 sz %4
  492.  
  493.  
  494.      If Qmodem says "unable to allocate swap space": QMODEM 4.2 will swap all
  495.      but approx. 5K to memory or disk when you shell out to DSZ. Go into
  496.      QINSTALL and make sure that /O /R Optimum Shell and Disk Shell are both
  497.      set to ON.
  498.  
  499.      For older Qmodem versions (before 4.2) change the %4 in upload scripts
  500.      to %3.
  501.  
  502.      2.5  GT POWER 13.00/14.00
  503.  
  504.      GT Power version 13/14 includes a YMRX.BAT (YMODEM-g receive) file with
  505.      an "rz" command.  You guessed it, "rz" is for ZMODEM protocol (the z
  506.      means ZMODEM!).  Please change the file to use the correct "rb -g" for
  507.      YMODEM-g.
  508.  
  509.      The files ZMTX.ARC and GT1300.NOT available on many bulletin boards
  510.      contain useful information for GT Power users.
  511.  
  512.      2.6  TELIX
  513.  
  514.      Telix has an internal ZMODEM, but some users prefer to use DSZ for
  515.      performance and/or reliability reasons.  Mat Fisher has published a
  516.      Telix script to call DSZ for automatic downloads.
  517.  
  518.      For those of you who use DSZ with Telix, here is a sample script file to use
  519.      instead of batch files:
  520.  
  521.      //////////////////////////////////////////////////////////////////////////
  522.      //Protocol salt file for Telix's external protocols by Matt Fisher
  523.      //Last edited (02/24/90)
  524.      //used for the DSZ ZMODEM protocol.  (It will work for u/ling and d/ling)
  525.      //////////////////////////////////////////////////////////////////////////
  526.  
  527.      str upload[80]  =
  528.  
  529.  
  530.  
  531.  
  532.  
  533.      Chapter 2 Pg 7        DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  534.  
  535.  
  536.         "c:elixrotocolDSZ port 1 pW1 pB4096 ha off sz -b -m -rr ";
  537.  
  538.      str download[80]=
  539.         "c:elixrotocolDSZ port 1 pW1 pB4096 ha off rz -b -m -rr ";
  540.  
  541.      //////////////////////////////////////////////////////////////////////////
  542.  
  543.      Main ()
  544.      {
  545.       if (_ext_filespec == "")
  546.        { strcat(download,_down_dir); dos(download,0); }
  547.       else
  548.        { strcat(upload,_up_dir); strcat(upload,_ext_filespec);  dos(upload,0); }
  549.      alarm(1);
  550.      }
  551.      //////////////////////// THE END /////////////////////////////////////////
  552.  
  553.      Simple but effective...
  554.  
  555.      --- TAGMAIL v2.20
  556.       * Origin: CRIMP/John Galt [Node 1] (1:120/144)
  557.  
  558.      --
  559.      INTERNET: Matt.Fisher@f144.n120.z1.FIDONET.ORG
  560.      NOTE: The DSZ command strings given above are quite unusual.  Instead of
  561.      the  "pW1  pB4096 ha off" one would be more likely to use "ha on" or "ha
  562.      sw" depending on the modem's flow control settings.
  563.  
  564.      2.7  BULLETIN BOARDS
  565.  
  566.      When installing DSZ on a bulletin board or host system, be sure to check
  567.      for proper operation when the caller hangs up while a file is being sent
  568.      or received.
  569.  
  570.      Currently, Only the TurboC version supports file sharing (shared read
  571.      access on files sent by  dsz).
  572.  
  573.      Some bulletin board interface routines do not call DSZ to send a file
  574.      until they have verified the file's presence by opening the file.  If
  575.      this checking is done in DOS's default exclusive open mode, dsz's file
  576.      sharing will be defeated.
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.      Chapter 3 Pg 8        DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  593.  
  594.  
  595.      3.  DESCRIPTION
  596.  
  597.      DSZ is a "protocol driver" that uses ZMODEM-90(TM), True YMODEM(TM), or
  598.      XMODEM to transfer files over a serial port with a variety of programs.
  599.  
  600.      DSZ has two main commands for ZMODEM transfers: "sz" sends file(s), and
  601.      "rz" receives them.
  602.  
  603.      When calling bulletin boards to download files with ZMODEM you can avoid
  604.      the bother of starting DSZ for each transfer by calling DSZ first,
  605.      before asking the BBS for the download.
  606.  
  607.              dsz t
  608.  
  609.      The "t" command allows you to keyboard the file request directly to the
  610.      BBS.  (The "t" stands for "terminal emulation".) Just give the "dsz t"
  611.      command from DOS or your comms program's DOS GATEWAY.  DSZ's ZMODEM
  612.      AutoDownload then receives the file automatically, using the filename
  613.      provided by the BBS, without any wasted keystrokes or delay.  Try it,
  614.      you'll like it!  (The "t" command is described below.)
  615.  
  616.      YMODEM downloads are almost as easy.  Use the "t" command as shown
  617.      above, and hit the F3 key after telling the board to download a file
  618.      with YMODEM.
  619.  
  620.      ZMODEM and True YMODEM(TM) transfers preserve exact file length and
  621.      modification time.
  622.  
  623.      DSZ supports XMODEM-1k (XMODEM with 1024 byte blocks, sometimes
  624.      mislabeled as ymodem) and CRC-16 with the sx -k and rc commands.
  625.  
  626.      DSZ is derived from Omen Technology's "Professional-YAM" high
  627.      reliability communications tools (also known as PowerCom(TM)) and Omen
  628.      Technology's ZCOMM User Supported Communications Software.  DSZ supports
  629.      a subset of Pro-YAM's file transfer related commands.  This
  630.      documentation makes extensive references to contemporary editions of the
  631.      Pro-YAM or ZCOMM manual, and is incomplete without it.  (Registered
  632.      copies include an alternate, copyrighted file.)
  633.  
  634.      DSZ is usually called from a communications or bulletin board program.
  635.  
  636.      DSZ uses its own modem I/O.  The original interrupt vector, UART parity,
  637.      and interrupt configuration are restored on exit.  The original state of
  638.      the 8259 interrupt mask bit for this vector is also restored on exit.
  639.  
  640.      DSZ uses DOS standard output (stdout) for messages.  DSZ never writes
  641.      directly to the screen.  DSZ expects its standard output to point to the
  642.      console, a logging file, or NUL, but never the modem port.  If dsz's
  643.      standard output is redirected to the modem (as with ProComm's Host mode
  644.      DOS shell), the combination will lock up the computer.  When necessary,
  645.      dsz's standard output can be redirected back to the console device with
  646.  
  647.  
  648.  
  649.  
  650.  
  651.      Chapter 3 Pg 9        DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  652.  
  653.  
  654.      the CON command.
  655.  
  656.      Users of pcAnywhere must use dsz's A command to disable pcAnywhere host
  657.      mode during file transfers.
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.      Chapter 3 Pg 10       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  711.  
  712.  
  713.      4.  COMMANDS
  714.  
  715.            ***********************************************************
  716.                                     NOTE WELL
  717.       Except as noted, all commands and options must be typed in lower case.
  718.                              DO NOT USE UPPER CASE!!
  719.                                Case is significant!
  720.            ***********************************************************
  721.  
  722.      Optional commands or arguments are shown in square brackets [].
  723.  
  724.      When used (in any combination), the A, CON, port, speed, handshake,
  725.      estimate, and d commands must be used in exactly this order.
  726.  
  727.      dsz [A] [CON] [F] [port N] [speed S] [handshake XX] [D] [d] [restrict]
  728.      command
  729.  
  730.  
  731.      4.1  List of Commands
  732.  
  733.      A     Suspend pcAnywhere operation during file transfers (available only
  734.            with DSZ.EXE).  The A command is used to avoid lockups caused by
  735.            pcAnywhere host mode.  This command should be given to the DSZ
  736.            running under pcAnywhere host mode.  Effective for PCA version 4.
  737.  
  738.            NOTE: A bug in the PCA Version 4 API causes the remote to
  739.            effectively lock up when DSZ executes the suspend-host command.
  740.            Currently the main workaround for this bug it to use VT-220
  741.            emulation on the pcAnywhere host and remote instead of pcAnywhere4
  742.            emulation.  Another possibility is to run AWREMOTE under DESQview,
  743.            set the window to SUSPEND AWREMOTE.EXE, and swap windows to a DOS
  744.            window from which DSZ, ZCOMM, or Professional-YAM can be run while
  745.            AWREMOTE.EXE is forced to remain inert.
  746.  
  747.  
  748.            EXAMPLE: C>dsz A sz *.foo Sends files from a pcAnywhere hosted
  749.            machine to you.
  750.  
  751.  
  752.            Fm: Al de la Torre
  753.  
  754.            1 sending from host to remote
  755.                   type: "dsz A sz filename.ext" ENTER
  756.                   shell to dos on remote machine (ctrl-Rshift)
  757.                   type: "dsz A rz" ENTER
  758.  
  759.            2 sending from remote to host
  760.                   type: "dsz A rz" ENTER
  761.                   shell to dos on remote machine (ctrl-Rshift)
  762.                   type: "dsz A sz filename.ext" ENTER
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.      Chapter 4 Pg 11       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  770.  
  771.  
  772.      CON   Redirect  message  output  to  the  DOS  "CON"  (console)  device,
  773.            overriding  any previous redirections.  This is necessary to avoid
  774.            lockups caused by ProComm host mode.  Most programs do not require
  775.            this hack.  This command is unique to DSZ.
  776.  
  777.      F     Leave the 16550A UART FIFO enabled on exit.  Since DSZ has no  way
  778.            to  read  the 16550A DMA mode and trigger level bits, these values
  779.            are not restored.
  780.  
  781.      port N select port N (n =  1,2,3,4,5,6,7,8,  10,11,12,13,14,15,16,17,18)
  782.            Default  is port 1 (COM1) or read from the DSZPORT dos environment
  783.            variable.  COM11 to COM18 refer to the COM1 to COM8 ports  on  the
  784.            PS/2.
  785.  
  786.            *****************************************************************
  787.                                           NOTE
  788.            Only COM1 and COM2 are standard on all  PC  compatible  computers.
  789.            Multiple  standards  exist for COM3 and above, so use only COM1 or
  790.            COM2 when first installing DSZ.
  791.            *****************************************************************
  792.  
  793.            DSZ COM3 uses 3E8 and IRQ4.  DSZ COM4 uses 2E8 and IRQ3.
  794.  
  795.            DSZ COM7 uses 2E8 and IRQ5.  DSZ COM8 uses 3E8 and IRQ5.
  796.  
  797.            If you wish to use COM3 or COM4 and your  computer  is  not  wired
  798.            according  to  one  of  these  choices,  you  MUST use the "portx"
  799.            command to specify base address and interrupt vector.
  800.  
  801.            EXAMPLE: to use COM2:
  802.            dsz port 2 rz
  803.  
  804.            In multitasking  operation,  accessing  a  port  used  by  another
  805.            running program will hang the machine.
  806.  
  807.  
  808.      portx base,irq To select an arbitrary port address and interrupt vector,
  809.            the  portx  command  must  be  used  instead  of the port command.
  810.            Please refer to DSZBG.DOC (provided on the Registration  Diskette)
  811.            or  the  Professional-YAM  or  ZCOMM  (ZCOMMDOC.ZIP)  manuals  for
  812.            details on this command.
  813.  
  814.            EXAMPLE: dsz portx 3e8,4 speed 2400 rz
  815.  
  816.  
  817.      speed S Set the specified speed.  This command is rarely needed because
  818.            DSZ reads the port's current speed by default.  Please refer to
  819.            the FLOW CONTROL, MAIN COMMANDS and SOFTWARE COEXISTENCE chapters
  820.            in DSZBG.ZOO or the ZCOMM or Pro-YAM manual for important
  821.            information about the speed command.
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.      Chapter 4 Pg 12       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  829.  
  830.  
  831.            Please study all the chapters of this document when using speeds
  832.            above 2400 bps.
  833.  
  834.            DSZ supports a maximum speed of 115200.  Not all hardware can
  835.            support that speed without errors.
  836.  
  837.  
  838.      handshake XX Enable one of several choices of hardware handshake.  (The
  839.            default is XOFF/XON software handshake).  This command is
  840.            documented in the ZCOMM or Pro-YAM manual, and in DSZBG.DOC.  (The
  841.            ZCOMM manual is available on all bulletin boards registered for
  842.            DSZ as ZCOMMDOC.ZIP.) On DSZ the "handshake" command may be
  843.            abbreviated to "ha".
  844.  
  845.      D     Disables the modem (drops Data Terminal Ready, DTR) if carrier is
  846.            lost.  This may be used to prevent spurious events (phone ringing)
  847.            from interfering with the calling bulletin board's recovery from
  848.            carrier loss.
  849.  
  850.      d     Disables carrier dropout monitoring, for modems that do not
  851.            properly drive the "Carrier Detect" input on the PC.  If you see a
  852.            No Carrier Detect message, you need to give the d command.  Before
  853.            using the d command, make sure you have the proper port
  854.            selected!!!
  855.  
  856.  
  857.      estimate length [speed] Use the specified length and optional specified
  858.            effective transfer speed for the next receive file to be created.
  859.            This command must come after any port, speed, or handshake
  860.            commands.  Please refer to DSZBG.ZOO or the ZCOMM User's manual
  861.            for details.
  862.  
  863.            The following makes DSZ calculate file transfer times on the basis
  864.            of 290 character per second aggregate transfer rate:
  865.  
  866.            EXAMPLE: dsz port 2 speed 9600 estimate 0 2900 rz
  867.  
  868.  
  869.  
  870.            EXAMPLE: dsz port 2 speed 9600 estimate 0 2900 sz bigmama.zip
  871.  
  872.  
  873.  
  874.      pxN   Set a numeric parameter x to N.  These parameters are mostly a
  875.            subset of the Pro-YAM/ZCOMM numeric parameters, and are listed
  876.            below.  They assume their defaults each time DSZ is called.
  877.            Without an argument, p displays the numeric parameters and their
  878.            values.
  879.  
  880.            EXAMPLE: C>dsz p
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.      Chapter 4 Pg 13       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  888.  
  889.  
  890.            z pxN Set zmodem numeric parameter x to N.  These parameters
  891.            correspond to the Pro-YAM or ZCOMM "zmodem" parameters and rarely
  892.            need changing.  These parameters assume their defaults each time
  893.            DSZ is called.  Without an argument, z p displays the zmodem
  894.            numeric parameters and their values.
  895.  
  896.  
  897.      restrict Restrict incoming pathnames (YMODEM/ZMODEM) to the current disk
  898.            and directory tree, and disallow modification or overwriting of
  899.            existing files.  This command is vital for bulletin boards
  900.            uploading files.  The restrict command causes partially received
  901.            files to be deleted.  When DSZ is restricted, it will refuse to
  902.            transfer files containing the string autoexec.bat and command.com
  903.            in upper or lower case.  This provides some defense from malicious
  904.            uploaded files.
  905.  
  906.            EXAMPLE: dsz restrict rz
  907.  
  908.  
  909.      t     [-T] [-8g] Talk with ZMODEM AutoDownload.
  910.  
  911.            The optional -T forces DSZ to exit after it has recognized a
  912.            ZMODEM AutoDownload(TM) request.
  913.  
  914.            The optional -8g (available on registered copies only) enables
  915.            reception of "BBS (ANSI) graphics" displays.  (A video device
  916.            driver such as ANSI.SYS must be loaded to support some types of
  917.            graphics.)
  918.  
  919.            A small subset of ZCOMM/Pro-YAM term function subcommands are
  920.            recognized:
  921.  
  922.            Keyboard F1 or ALT-X to exit.
  923.  
  924.            F3 receives file(s) with True YMODEM(TM),
  925.  
  926.            ALT-P toggles parity between the 8n default and 8g (enables ANSI
  927.            "graphics").
  928.  
  929.            ALT-H toggles two local echo ("Half Duplex") modes; the second
  930.            displays a newline (CR/LF) when Enter is keyboarded.
  931.  
  932.            Keyboarded ASCII characters are sent to the modem.
  933.  
  934.            ALT-B sends a break.
  935.  
  936.            Characters from the modem print on the screen.  A device driver
  937.            such as ANSI.SYS may be used to recognize escape sequences.
  938.  
  939.            DSZ's ZMODEM AutoDownload(TM) detects the start of a ZMODEM file
  940.            download and accepts the file(s) without operator intervention.
  941.  
  942.  
  943.  
  944.  
  945.  
  946.      Chapter 4 Pg 14       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  947.  
  948.  
  949.      rz    [-abeEmMnpPrt+YZy] [dir] [file ...]     (ZMODEM-90 receive) **
  950.  
  951.      rz    [-abenprt+Yy] [dir] [file ...]          (ZMODEM receive) **
  952.  
  953.      rb    [-abt+y] [dir] [file ...]     (YMODEM receive) **
  954.  
  955.      rb -g [-abt+y] [dir] [file ...]     (YMODEM-g receive) **
  956.  
  957.      rc    [-abt+y] file1                (XMODEM/CRC receive)
  958.  
  959.      ro    [-abt+y] file1                (XMODEM OverThruster receive)
  960.  
  961.      rx    [-abt+y] file1                (XMODEM receive)
  962.  
  963.      rx -g [-abt+y] file1                (Qmodem-G receive) **
  964.  
  965.            ** Download directory specification and -g ignored w/o
  966.            registration
  967.  
  968.  
  969.      sz    [-abefnprtFYQS+yZ] [-w[N]]  [PREFIX=p | ONAME=n] file ...(ZMODEM
  970.            send)
  971.  
  972.      sz    [-abeEfmMnpPrtFYQS+yZ] [-w[N]]  [PREFIX=p | ONAME=n] file
  973.            ...(ZMODEM-90 send)
  974.  
  975.            Pathnames are separated by spaces.  Wildcards are OK.
  976.  
  977.            EXAMPLE: dsz port 2 sz -r /tmp/file1 /tmp/file3 *.c
  978.  
  979.  
  980.            The "sz" and "sb" commands exploit DOS's tree structured file
  981.            system.  A directory or disk specifier expands to all files in
  982.            that directory.
  983.  
  984.            EXAMPLE: dsz port 2 sz -r C:srcdir
  985.  
  986.  
  987.            If you use PREFIX= or ONAME= with the "sb" or "sz" commands, these
  988.            pathnames should be entered in lower case unless the underlying
  989.            file system supports upper AND lower case.
  990.  
  991.            EXAMPLE: dsz port 2 sz -r ONAME=newsrc.c temp.c
  992.  
  993.  
  994.  
  995.      sb    [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM or YMODEM-g send)
  996.  
  997.      sb -k [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM-1k or YMODEM-g
  998.            send)
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.      Chapter 4 Pg 15       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1006.  
  1007.  
  1008.      sx    [-t] file1                    (XMODEM, XMODEM/CRC, Qmodem-G send)
  1009.  
  1010.      sx -k [-t] file1                    (XMODEM-1k send)
  1011.  
  1012.  
  1013.      v     Verify the serial number by writing a log entry (see DSZLOG).
  1014.  
  1015.            v      1     0 bps    0 cps   0 errors     0  128 s/n 666
  1016.  
  1017.            The letter "v" indicates a verification entry.  The first numeric
  1018.            field is 1 if YMODEM-g is supported.  The last field is the serial
  1019.            number.  Unregistered copies show a s/n of 0.
  1020.  
  1021.  
  1022.      o     Turn off Data Terminal Ready (DTR), terminating ("offing") the
  1023.            connection if the modem responds to DTR.  Useful with the "t"
  1024.            command to disconnect afterwards.
  1025.  
  1026.            EXAMPLE: dsz t o
  1027.  
  1028.  
  1029.  
  1030.      LARG  Convert ARG to lower case, then parse arg.
  1031.  
  1032.  
  1033.      The meanings of optional arguments to the file transfer commands are
  1034.      described in DSZBG.DOC and the ZCOMM/Pro-YAM manual.
  1035.  
  1036.      The s (SlugBait) option prevents a receiver from receiving a file
  1037.      without accounting for it.  Attempts to do so are flagged with a Q
  1038.      status in the log file.  This option can cause a transfer that
  1039.      legitimately fails near the end of the file to be reported as
  1040.      Questionable rather than ERROR.  SlugBait causes DSZ to return success
  1041.      if at least one file is transferred.
  1042.  
  1043.      Send files may be specified indirectly:
  1044.                                dsz sz @C:files.lst
  1045.      sends the files in C:files.lst.  This provides another means of
  1046.      bypassing the DOS command line limit.  The first letter must be "@" and
  1047.      the third letter must be ":" to distinguish this from an ordinary
  1048.      pathname.  Pathnames in the indirection file may be separated by any
  1049.      combination of space(s), tab(s), CR and/or LF.  No spaces may appear
  1050.      inside a pathname; "FOO     .BAR" won't work.
  1051.  
  1052.      A list of files to send may be built up with a command like:
  1053.  
  1054.      EXAMPLE: dir *.zip > files.tmp
  1055.  
  1056.      This file can be edited to remove unwanted files.  Then you send the
  1057.      files with:
  1058.      DSZ sz -m @c:files.tmp
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.      Chapter 4 Pg 16       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1065.  
  1066.  
  1067.      4.2  Interrupt Keys
  1068.  
  1069.      Ctrl-Break Terminates the transfer in progress.
  1070.  
  1071.      ALT-N Abruptly terminates (NUKES) the transfer in progress.
  1072.  
  1073.      Ctrl-X Typing a dozen Ctrl-X characters to another ZMODEM program
  1074.           terminates ZMODEM operations.
  1075.  
  1076.      ALT-F Skips the current file in ZMODEM transfers.
  1077.  
  1078.      ALT-B Cancels the current ZMODEM session.
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.      Chapter 5 Pg 17       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1124.  
  1125.  
  1126.      5.  NUMERIC PARAMETERS
  1127.  
  1128.      DSZ uses the following main numeric parameters, settable with the pxN
  1129.      command.
  1130.  
  1131.      EXAMPLE: C>dsz pQ0 rz -rr
  1132.  
  1133.  
  1134.      **************************************************************************
  1135.      NOTE: Parameter setting commands such as "pd0" cannot be added to
  1136.      DSZOPT, they must be included in the command line.
  1137.      **************************************************************************
  1138.  
  1139.      In addition, DSZ uses the Pro-YAM/ZCOMM zmodem numeric parameters
  1140.      described in the Pro-YAM/ZCOMM reference manual (ZCOMMDOC.ZIP) and in
  1141.      DSZBG.DOC.
  1142.  
  1143.  
  1144.      B   Set the size of buffer used for disk reads and writes.  The default
  1145.          is 1024, 4096 maximum (16384 max on DSZ.EXE).  If your copy of DSZ
  1146.          is running on a floppy disk system or a very slow turkey hard disk,
  1147.          a larger value may give better results.  Too large a value may
  1148.          exhaust memory, induce receiver timeouts, cause disconnects(!), or
  1149.          generate spurious CRC errors.  If performance logging doesn't work,
  1150.          this parameter is too big.
  1151.  
  1152.          EXAMPLE: C>dsz pB4096 sz A:floppy.fil
  1153.  
  1154.          Setting the buffer size may lock out the performance log, DSZFILES,
  1155.          and/or indirect pathname list in DSZ.COM.
  1156.  
  1157.          IF YOU AREN'T BLOODY SURE YOU NEED A BIGGER BUFFER, DON'T USE ONE.
  1158.  
  1159.          Please understand that the B parameter has nothing to do with
  1160.          anything you've heard about 128, 1024 or 8192 byte XMODEM style
  1161.          blocks.  Normally, ZMODEM's block size is the entire file.
  1162.  
  1163.      O   This parameter controls XMODEM OverThruster(TM).  It is described in
  1164.          dszbg.doc.  This file is part of the software package sent to paid
  1165.          registrants.
  1166.  
  1167.      P   After a "speed" command, if you give a p command (display
  1168.          parameters), the P parameter value will indicate the type of serial
  1169.          I/O UART chip detected.  DSZ automatically detects and enables the
  1170.          FIFO on the NS16550A, NS16550AFN, and Intel 82510 chips.
  1171.  
  1172.          EXAMPLE: dsz port 1 speed 19200 p
  1173.  
  1174.  
  1175.          0  Indicates a standard 8250 or 16450 UART with no special features.
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.      Chapter 5 Pg 18       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1183.  
  1184.  
  1185.          1  Indicates an NS16550AN or NS16550AFN with 16 deep receive FIFO.
  1186.             These are the preferred chips.
  1187.  
  1188.          2  Indicates an Intel 82510 with 3 deep receive FIFO.
  1189.  
  1190.          The sequence "port 1 pP1 speed 19200" bypasses DSZ's verification
  1191.          checks normally performed on the FIFO configuration and may allow
  1192.          defective FIFO logic on certain chips to be used.  This incantation
  1193.          is not required for the NS16550AN or NS16550AFN.
  1194.  
  1195.          The sequence "pP-1 speed 2400" should be used with the Western
  1196.          Digital WD16550 chip to disable the non standard FIFO on that chip.
  1197.          The WD16550 FIFO has been observed to lose data when transmitting at
  1198.          2400 bps and slower speeds.  The minimum speed for normal transmit
  1199.          FIFO operation with the WD16C550 may vary with different computers.
  1200.  
  1201.  
  1202.      Q   Error code returned to DOS (default 1).  (Success always returns 0.)
  1203.          Some programs toss cookies when confronted with certain exit codes.
  1204.  
  1205.          EXAMPLE: dsz pQ-1 sz foo.bar
  1206.  
  1207.  
  1208.          DSZ reports an error if no files have been transferred, even if the
  1209.          command used wasn't supposed to transfer any file(s).
  1210.  
  1211.  
  1212.      R   If set to 1, causes partially received files to be deleted.
  1213.  
  1214.          EXAMPLE: DSZ pR1 rz
  1215.  
  1216.  
  1217.  
  1218.      S   Timeout in seconds (default 15) waiting for restraint release (XON
  1219.          and/or handshake).
  1220.  
  1221.      W   Wait for Enter key before exiting after an error.  Effective only on
  1222.          registered copies.  Useful when calling DSZ from DESQview, allows
  1223.          the window to close unless there is an error message that should
  1224.          remain visible.
  1225.  
  1226.          EXAMPLE: C>dsz pW1 sz foo.bar
  1227.  
  1228.  
  1229.      Y   Control byte for the NS16550AN/NS16550FAN FCR register.  If you
  1230.          don't know what the FCR does, don't change this parameter.  It has
  1231.          been suggested that a different value (129) may improve multitasking
  1232.          under DESQview when multiple copies of DSZ are active.
  1233.  
  1234.      a   Calibrates certain protocol timeouts used with XMODEM and YMODEM
  1235.          transfers (Cybernetic Data Recovery(TM)).  This parameter does not
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.      Chapter 5 Pg 19       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1242.  
  1243.  
  1244.          affect ZMODEM transfers.
  1245.  
  1246.          The a numeric parameter is automatically set to 2000 for a 4.77 mHz
  1247.          PC or XT, 4000 for a PS2/30, 6000 for an 8 mHz 1ws AT, and 12000 for
  1248.          a PS2/80.  If your computer has a speedup card or otherwise runs
  1249.          unusually fast (or slow!) for its type, you may set the a numeric
  1250.          parameter to a value that reflects its speed.
  1251.  
  1252.          EXAMPLE: dsz port 2 pa4000 rb
  1253.  
  1254.  
  1255.          NOTE: Setting this parameter does not suppress the "Unknown Machine
  1256.          Type" message which is displayed before the command line is scanned.
  1257.  
  1258.      d   A non zero value (the default) causes incoming files received with
  1259.          ZMODEM and full YMODEM transfers to have their Date set to that sent
  1260.          in the file header.  ZMODEM's file management features depend on the
  1261.          transmission of each file's modification date.  Files will have the
  1262.          same creation date, even if the two machines are in different time
  1263.          zones.  When transferring files to/from a Unix system, creation
  1264.          dates are interpreted according to GMT or Universal Coordinated
  1265.          Time.  File dating may be disabled with a pd0 command, which causes
  1266.          files to assume the date and time they were received.
  1267.          NOTE: Backdating file creation times may confuse some backup
  1268.          programs.
  1269.  
  1270.      v   Verbose level (debugging output) Negative values inhibit some
  1271.          routine messages.  Setting v to 1 or greater causes serialized
  1272.          copies to ring the bell when a transfer is done.
  1273.  
  1274.          EXAMPLE: dsz pv1 port 2 rz
  1275.  
  1276.  
  1277.      z   Timezone in minutes behind GMT, used for ZMODEM and True YMODEM file
  1278.          transfers to coordinate the actual date of the file with computers
  1279.          in other time zones.  Effective on registered copies.  PDT or MST
  1280.          corresponds to 420.  This may be preset with the ZONE DOS
  1281.          environment variable.
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.      Chapter 6 Pg 20       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1301.  
  1302.  
  1303.      6.  ENVIRONMENT VARIABLES
  1304.  
  1305.      The following DOS environment variables may be set to modify DSZ
  1306.      operation.  DOS environment variables are set by giving a command to
  1307.      DOS.
  1308.  
  1309.  
  1310.      EXAMPLE: set DSZPORT=2
  1311.  
  1312.  
  1313.      The following form may be used for arbitrary address/vector
  1314.      combinations:
  1315.  
  1316.      EXAMPLE: set DSZPORT=3e8,4
  1317.  
  1318.      These DOS "set" commands may be placed in your AUTOEXEC.BAT file or
  1319.      given just before you run your communications program.
  1320.  
  1321.      IMPORTANT! Do not add spaces to these commands!!
  1322.      set DSZPORT  =  2 WILL NOT WORK!
  1323.  
  1324.  
  1325.      DIRRX (Registered copies only.) Specifies the directory to receive
  1326.          (download) files.  If the sting in DIRRX ends with "/", directory
  1327.          and/or disk designators in the incoming pathname are stripped, and
  1328.          only the stem (name and extension) is used.  Otherwise, if an
  1329.          incoming file has an absolute pathname, the incoming pathname is
  1330.          used.
  1331.  
  1332.          EXAMPLE: set DIRRX=C:/modem/download/dsz/
  1333.          dsz rz -r
  1334.          downloads files to the /modem/download/dsz directory on the C:
  1335.          drive, with ZMODEM Crash Recovery..
  1336.  
  1337.  
  1338.          EXAMPLE: set DIRRX=B:/
  1339.  
  1340.          The DOS "set" command defining the receive directory may be placed
  1341.          in your AUTOEXEC.BAT file.  Make certain there is enough environment
  1342.          space to hold this value.  Confirm this by typing "set" to the DOS
  1343.          prompt and verifying the DIRRX value is listed correctly.
  1344.  
  1345.      DSZFILES May contain a list of up to 9999 pathnames to transmit, with
  1346.          entries separated by spaces.  If present, DSZFILES is used in place
  1347.          of a normal command line list of files to send with the sb and sz
  1348.          commands.
  1349.  
  1350.          EXAMPLE: C>set DSZFILES=file1 file2 file3 *.c
  1351.          C>dsz port 2 handshake on sz -rr
  1352.  
  1353.          In practice, this string would be built up by a calling program and
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.      Chapter 6 Pg 21       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1360.  
  1361.  
  1362.          passed to DSZ with a "spawnvpe", "execvpe", or similar subroutine
  1363.          call.
  1364.  
  1365.          SEE ALSO: Pathname list specification @C:files.lst
  1366.  
  1367.      DSZLOG log file to receive entries for files sent and received.
  1368.          (Default null).  Sample entries:
  1369.  
  1370.      Z  46532 38400 bps 3324 cps   0 errors    66 1024 DSZ.COM 1177
  1371.      Z 124087 19200 bps 1880 cps   0 errors     6 1024 MXY.TMP 1177
  1372.  
  1373.          Transfer times are based on the DOS time of day clock and have up to
  1374.          two seconds' uncertainty.  As with all protocol throughput reports
  1375.          generated by Omen Technology programs (and contrary to the false
  1376.          claims of some critics), DSZ's throughput figures for ZMODEM,
  1377.          Kermit, and True YMODEM(TM) transfers do not take "credit" for
  1378.          pathname and/or protocol overhead characters.  DSZ's throughput
  1379.          reports do not include the time required to send the pathname.  This
  1380.          understates the true time required to transfer files, but the time
  1381.          required to send the pathname often depends on the alacrity of the
  1382.          operator, and thus does not always reflect the performance of the
  1383.          protocol itself.
  1384.  
  1385.          Transfers measuring less than one second are reported as having 9999
  1386.          characters per second throughput.
  1387.  
  1388.          The unlabeled numeric field after the error (retry) count is the
  1389.          number of flow control stoppages encountered sending the file.  This
  1390.          number gives an indication of flow control restrictions (overloaded
  1391.          networks, etc.) encountered during the transfer.
  1392.  
  1393.          The last numeric field before the file name is the YMODEM block size
  1394.          or ZMODEM subpacket length used for the last block in the file.
  1395.  
  1396.          The last field is the serial number of the other program, or -1 if
  1397.          this information is not available.
  1398.  
  1399.          The code letter indicates the type of transfer, Z (ZMODEM), S
  1400.          (X/YMODEM), R (X/YMODEM), E (error), or L (transfer terminated by
  1401.          loss of data carrier).
  1402.  
  1403.          WARNING: If DSZ encounters a loss of carrier or other fatal error
  1404.          condition before a file COMMENCES transmission, a log entry may not
  1405.          be made.
  1406.  
  1407.  
  1408.          EXAMPLE: C>set DSZLOG=C:/yam/dszlog
  1409.  
  1410.  
  1411.          IMPORTANT! NO SPACES!!
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.      Chapter 6 Pg 22       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1419.  
  1420.  
  1421.      DSZOPT (Registered copies only) String containing default options for
  1422.          DSZ file transfers.  Options are optional modifiers to the DSZ sz,
  1423.          rz, sx, rx, sb, rb commands.
  1424.  
  1425.          A T may be appended to the string to force DSZ to exit after it has
  1426.          recognized a ZMODEM AutoDownload(TM) request.
  1427.  
  1428.          An 8g may be appended to the string to make BBS (ANSI) graphics the
  1429.          default for DSZ's t command.  The ability to preset these options is
  1430.          especially helpful for controlling ZMODEM automatic downloads from
  1431.          DSZ's t command.
  1432.  
  1433.          EXAMPLE: C>set DSZOPT=r
  1434.          Enables DSZ's Intelligent Crash Recovery(TM) as a default.
  1435.  
  1436.          Let's say you wish ZMODEM crash recovery, and BBS "graphics" for the
  1437.          DSZ term function:
  1438.          C>set DSZOPT=r8g
  1439.  
  1440.  
  1441.          If you're downloading files from GEnie with an MNP modem, the
  1442.          following will speed up your downloads with Genie's ZMODEM-90Tm.
  1443.          (You can recognize ZMODEM-90 on GEnie two ways: 1) MobyTurboTm is
  1444.          used to speed ZIP and ARC downloads, 2) "sz 4.xx" is displayed at
  1445.          the end of transfer.  As of this writing, ZMODEM-90 may not be
  1446.          available in all libraries.) Note that (as usual with DSZ) case is
  1447.          significant: the "r" must be lower case, the "W" upper case.
  1448.          C>set DSZOPT=rW16384
  1449.  
  1450.  
  1451.          WARNING: Do NOT include "ena" or any other commands in the DSZOPT
  1452.          string.  With the exception of the "8g" mode, only **options** may
  1453.          be placed in the DSZOPT string!  (Options are the letters that
  1454.          modify the sz, rz, sb, etc. commands.  In "rz -r", "r" is an
  1455.          option.)
  1456.  
  1457.          Parameters can not be set in DSZOPT.
  1458.  
  1459.      MAXBYTES Maximum number of bytes allowed for transfer.  If this number
  1460.          is exceeded, DSZ skips the offending files (ZMODEM) or aborts
  1461.          remaining files in the batch (YMODEM).
  1462.  
  1463.      DSZPORT Default communications port override, default 1.
  1464.  
  1465.          EXAMPLE: C>set DSZPORT=2
  1466.  
  1467.          IMPORTANT! NO SPACES!!
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.      Chapter 6 Pg 23       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1478.  
  1479.  
  1480.      ZONE sets the z numeric parameter to the number of minutes the current
  1481.          local time lags GMT time.  PDT or MST corresponds to 420.  PST
  1482.          corresponds to 480.
  1483.          EXAMPLE:
  1484.          C>set ZONE=420
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.      Chapter 7 Pg 24       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1537.  
  1538.  
  1539.      7.  EXIT STATUS
  1540.  
  1541.      DSZ exits with 0 status for successful transfers, or the value of the Q
  1542.      numeric parameter (default 1) if a file transfer failed, or if no files
  1543.      were transferred.  Many languages and "door" programs do not return this
  1544.      information to the calling program.  Some languages and "door" programs
  1545.      freak out (hang) on certain non-zero exit values.
  1546.  
  1547.      A batch file that calls DSZ directly may be used to detect the DSZ exit
  1548.      status with the DOS "errorlevel" construct.  Please refer to the Q
  1549.      numeric parameter below for more information.
  1550.  
  1551.      DSZ's log file entries may also be examined to determine the success or
  1552.      failure of a file transfer.
  1553.  
  1554.      DSZ commands are an improper subset of Pro-YAM/PowerCom/ZCOMM commands.
  1555.      The file transfer commands are fully described in ZCOMMDOC.ZIP, the
  1556.      ZCOMM User's Manual.  Relevant portions of the ZCOMM User's Manual are
  1557.      provided in DSZBG.ZOO, a Copyrighted file included with the DSZ
  1558.      registration disk.  You may refer to one of those documents for details
  1559.      on the following commands.
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.      Chapter 8 Pg 25       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1596.  
  1597.  
  1598.      8.  EXAMPLES
  1599.  
  1600.      dsz sz c:foo.zip              (send 1 file with ZMODEM)
  1601.  
  1602.      dsz sz -m c:*.zip             (send all .ZIP files with MobyTurbo(TM))
  1603.  
  1604.      dsz sz f1.c f2.c f3.c         (send 3 files with ZMODEM)
  1605.  
  1606.      dsz sz c:foo.* b:*.c          (send multiple files with ZMODEM)
  1607.  
  1608.      dsz sz -Z *.lst               (send text files with ZMODEM compression)
  1609.  
  1610.      dsz sz -r bigone.zip          (CRASH RECOVERY: resume interrupted
  1611.      transfer)
  1612.  
  1613.      dsz rz -r                     (CRASH RECOVERY: resume interrupted
  1614.      transfer)
  1615.  
  1616.      dsz rz -rr                    (CRASH RECOVERY with file comparison)
  1617.  
  1618.      dsz handshake both sz yamdemo.zip       (Hardware+Software handshake)
  1619.  
  1620.      dsz sz -n *.*                 (send files that are newer or rx has no
  1621.      copy)
  1622.  
  1623.      dsz sz -Yn *.*                (Only send files that are newer than
  1624.      receiver's copy)
  1625.                                    (Do not send files that do not exist on
  1626.      receiver's disk)
  1627.  
  1628.      dsz rz C:/UPLOADS             (receive files to specified directory #)
  1629.  
  1630.      dsz port 2 speed 38400 handshake both restrict rz
  1631.                                    (Restrict provides protection for BBS's)
  1632.  
  1633.      dsz rz  -y prog.zip           (ZMODEM, single file pathname override)
  1634.  
  1635.      dsz z pr1 rx foo.dat          (XMODEM receive, remove file if error)
  1636.  
  1637.      dsz pO60 ro foo.dat           (XMODEM/OverThruster receive, GEnie MNP #)
  1638.  
  1639.      DSZ LRC L-Y NEWPROG.ZIP       (generate lower case "rc -y" command)
  1640.  
  1641.      dsz sz foo >debug.dmp         (Debugging data dump)
  1642.  
  1643.      dsz sz @C:/bbs/files.lst      (Indirect file list)
  1644.  
  1645.      dsz sz -u *.lst               (Unlink (Delete) files as they are sent)
  1646.  
  1647.      # Registered copies only
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.      Chapter 8 Pg 26       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1655.  
  1656.  
  1657.      9.  BACKGROUND OPERATION
  1658.  
  1659.      Three DESQview description files are provided to demonstrate background
  1660.      operation with modest (66 kb window) memory requirements.  DSZ uses
  1661.      tight C/ASM code, table driven CRC generators, and buffered receive and
  1662.      transmit for good performance in the background without hogging CPU
  1663.      cycles.  On a QIC Labs 8 mHz PC-AT clone, DSZ can download files in the
  1664.      background (3 background clock ticks, 9 foreground clock ticks) with a
  1665.      throughput better than 9600 bps.
  1666.  
  1667.      2S   Prompts for file name(s) and sends them with ZMODEM protocol.
  1668.           File: 2S-PIF.DVP
  1669.  
  1670.      2T   Talks to the modem and allows manual YMODEM (F3) or automatic
  1671.           ZMODEM downloads.  File: 2T-PIF.DVP
  1672.  
  1673.      2A   Like 2T, but using Quarterdeck's dvansi.com memory resident ANSI
  1674.           CRT device driver to process ANSI screen codes.  File: 2A-PIF.DVP
  1675.           DS.BAT is the batch file used by 2A.
  1676.  
  1677.      These files are written for a port 2 local connection and \TMP
  1678.      directory, but may be modified to suit your requirements using the
  1679.      DESQview CP command.  The W numeric allows DESQview to close the window
  1680.      after DSZ finishes, providing a pleasant user interface.
  1681.  
  1682.      Other DVPs, Scripts, and Batch files are available on the DESQView
  1683.      conference on the Sound of Music as DVDSZ20Z.ARC.
  1684.  
  1685.      Please consult the DESQview documentation for instructions on
  1686.      installation procedure for the DVP files.
  1687.  
  1688.      Operation at high speed (above 9600 bps) may require the DESQview
  1689.      "Optimize communications" performance Advanced Setup option.
  1690.  
  1691.      Newer versions of DESQview may require more "common memory" allocation
  1692.      (6-8 k bytes) to operate with DSZ.  Some versions of DESQview do not
  1693.      operate properly with DSZ; DESQview 2.0 is known to work, and DESQview
  1694.      2.25 is reported to have fixed bugs in intermediate versions.
  1695.  
  1696.      On 286 and 386 machines, some DESQview operations involve swapping
  1697.      memory contents with buffers in extended memory.  As with extended
  1698.      memory ramdisks and disk caches, this causes errors with high speed
  1699.      communications.  The considerations discussed in the "286 and 386
  1700.      Extended Memory" subchapter apply here.  Since this DESQview extended
  1701.      memory swapping is asynchronous with respect to DSZ's file transfers,
  1702.      "handshake slow" doesn't help here.  The solution is to force DESQview's
  1703.      memory swaps to use smaller blocks (with interrupts allowed between
  1704.      blocks) and/or use NS16550AN or NS16550AFN chips for the serial
  1705.      interface.
  1706.  
  1707.      If you see funny characters on the screen while a program is loading,
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.      Chapter 9 Pg 27       DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1714.  
  1715.  
  1716.      you have a conflict between the display adapter and QEMM memory manager
  1717.      which may cause lockups.  If so you must explicitly exclude the display
  1718.      adapter's memory with an EXCLUDE clause in QEMM's config.sys entry.
  1719.  
  1720.            ***********************************************************
  1721.                                      WARNING
  1722.      When running DSZ under a multi tasking system such as DESQview, do not
  1723.      allow two programs to access the same comm port at the same time.  At
  1724.      best, such actions will disrupt communications.  At worst, your computer
  1725.      will attempt to open a subspace channel to V'ger.
  1726.  
  1727.      Tell DESQview to use the SPECIFIC port number you are using, and not "Y"
  1728.      to the question: "Uses serial Ports (Y, N, 1, 2)"
  1729.  
  1730.      When running a comm program under DESQview or any related multitasking
  1731.      executive, DSZ must be called directly from the comm program, in the
  1732.      same window.  DO NOT open a separate window for DSZ unless you were
  1733.      about to power down the computer anyway.
  1734.            ***********************************************************
  1735.  
  1736.      With some communications programs, you can make the call, log in, and
  1737.      then exit (closing the window) without disconnecting the modem.  At this
  1738.      time you can fire up DSZ with the "t" command to allow YMODEM or ZMODEM
  1739.      downloads in a small window.
  1740.      Example File: 2A-PIF.DVP
  1741.  
  1742.      Alternatively, you can start DSZ from the DOS prompt, then type "AT"
  1743.      commands to the modem to call the bulletin board.  DESQview's "learn"
  1744.      facility may be helpful here.
  1745.  
  1746.      9.1  Windows 3
  1747.  
  1748.      Communications programs do not operate well under Windows 3 because
  1749.      Windows does not have true multitasking.
  1750.  
  1751.      9.2  VM
  1752.  
  1753.      According to Marshall Sutherland, Be sure to set IOPL3 mode to YES.
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.      Chapter 10 Pg 28      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1773.  
  1774.  
  1775.      10.  FLOW CONTROL
  1776.  
  1777.      If you plan to send files over Telenet (PC-Pursuit), you must refer to
  1778.      the Pro-YAM or ZCOMM Reference manual (in ZCOMMDOC.ZIP) FLOW CONTROL
  1779.      chapter for vital information on flow control considerations necessary
  1780.      for proper operation of ZMODEM and other streaming protocols.
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.      Chapter 11 Pg 29      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1832.  
  1833.  
  1834.      11.  ERROR MESSAGES
  1835.  
  1836.      COM2 1200 bps Carrier Detect enabled Handshake slow
  1837.      Command line = (commands)
  1838.      This is a normal message displayed to help resolve problems with
  1839.      incorrect batch files.  The port number, speed, carrier detect
  1840.      ("enabled" or "DISABLED") and "handshake" indicate the selected mode of
  1841.      operation.
  1842.  
  1843.      DSZ FINISHED! exit code = 0
  1844.      This is DSZ's normal exit when at least one file has been transferred
  1845.      and no unrecoverable errors have been detected.  If an error such as a
  1846.      failed file transfer had been detected, the exit code would be 1, or the
  1847.      value set in the Q numeric parameter.
  1848.  
  1849.      As the message implies, DSZ has done all of its processing, and has
  1850.      return the communications port and vector to its original value before
  1851.      displaying this message.  If the computer locks up after this message is
  1852.      displayed, there's something wrong with the program that called DSZ, not
  1853.      with DSZ itself.
  1854.  
  1855.      Unknown Machine Type XX, 'a' parameter preset to 6000 indicates a ROM
  1856.      BIOS that does not follow the IBM specification for identifying the
  1857.      machine type.  If your computer causes DSZ to display this message, you
  1858.      may set the a numeric parameter described elsewhere in this document.
  1859.      This message is generated before any commands are read, so do not be
  1860.      alarmed when you "discover" that setting the a parameter doesn't make
  1861.      this message go away.  The a parameter does not affect ZMODEM transfers.
  1862.  
  1863.      Please send us a postcard or letter indicating the reported hex value
  1864.      for machine Type, name of the computer, and its speed so we can include
  1865.      that machine type in a future release.
  1866.  
  1867.      Need more memory to run DSZ or Abnormal program termination is displayed
  1868.      by the TurboC startup routine if DSZ is run in too small a memory
  1869.      partition.  If you see this message, use a larger memory partition for
  1870.      DSZ or remove some memory resident programs.  This message may also
  1871.      appear if the calling program fails to free memory before calling DSZ.
  1872.  
  1873.      No Carrier Detect is displayed when DSZ recognizes a lack of carrier
  1874.      detect signal from the modem.  Most support calls concerning "No Carrier
  1875.      Detect" are caused by the user failing to tell DSZ to use the correct
  1876.      port.  DSZ does not magically divine the COM port number; if the default
  1877.      COM1 is incorrect, DSZ must be told what port to use with the port
  1878.      command or the DPORT environment variable.
  1879.  
  1880.      No Carrier Detect may also be caused by a line disconnect, defective
  1881.      cable, or incorrect modem strapping.  It may be disabled with the d
  1882.      command.  Sometimes this is caused by setting the B parameter to too
  1883.      large a value.
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.      Chapter 11 Pg 30      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1891.  
  1892.  
  1893.      Garbage Count Exceeded Indicates ZMODEM has not detected a valid start
  1894.      of header in a reasonable number of characters.
  1895.  
  1896.      If DSZ becomes "stuck" on emitting this messages, it is possible the
  1897.      sending program may not be able to recognize and act upon transmission
  1898.      requests (ZROPS headers).  The sending program should be corrected.  In
  1899.      the meantime, setting a ZMODEM packet length with the "zmodem pl4096"
  1900.      ("l" is the small letter l) command will force the sender to wait for
  1901.      the receivers' progress reports.
  1902.  
  1903.      Permission denied comes from the Microsoft C Library.  This is caused by
  1904.      attempts to modify a read only file or directory, or to create a file in
  1905.      a nonexistent directory.
  1906.  
  1907.      A furtive flashing appearance of XOFF or FLOW during ZMODEM or YMODEM-g
  1908.      file sending signifies DSZ is responding to flow control restraint.
  1909.      This is normal operation when buffered modems or packet switched
  1910.      networks are used.  ZMODEM's robustness and reliability allow creative
  1911.      users to transfer files over unusual multiple computer lash-ups, causing
  1912.      modem data lights and computer status displays to dance in unfamiliar
  1913.      rhythms.
  1914.  
  1915.      Output FLow Control Restraint RELEASED Indcates DSZ has not received a
  1916.      positive flow control signal (XON and/or CTS as specified by the
  1917.      handshake command) within the timeout specified by the S numeric
  1918.      parameter.  This message may appear as the result of line noise.  If it
  1919.      appears often, it may indicate improper flow control settings, defective
  1920.      modem and/or cable, or (rarely) too small a value for the S numeric
  1921.      parameter.
  1922.  
  1923.      Not allowed to overwrite %s By default, DSZ will not overwrite an
  1924.      existing file.  Use the -y or -n or -r option to overwrite/update
  1925.      existing files.
  1926.  
  1927.  
  1928.      11.1  Got ZRPOS
  1929.  
  1930.      Got ZRPOS indicates the receiving program has detected a transmission
  1931.      error and has requested retransmission.  In other words, ZMODEM is doing
  1932.      its job of detecting and correcting missing and garbled data.
  1933.  
  1934.      If this happens more often than observed line errors would indicate is
  1935.      reasonable, the receiver's error messages must be studied.  Line Status
  1936.      Register errors generally indicate a local problem; if the receiver
  1937.      gives "Line Status Register 02" errors the problem lies with the
  1938.      receiver.
  1939.  
  1940.      Otherwise, the sender may have a flow control problem in one of four
  1941.      areas:
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.      Chapter 11 Pg 31      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  1950.  
  1951.  
  1952.        + Between the sending program and its modem.  If using an interface
  1953.          speed higher than the transmission speed, or modem to modem error
  1954.          correction (MNP, LAPB, PEP, etc.), check that the modem and the
  1955.          sending program are configured for the same flow control methods.
  1956.          Omen Technology's software is faster than most other programs, and
  1957.          may expose flow control problems not seen with slower software.
  1958.  
  1959.        + Between the sending modem and the network.  Correcting this requires
  1960.          "handshake both" to allow the sending program to honor both hardware
  1961.          (CTS) flow control from the modem and software flow control
  1962.          (XON/XOFF) from the network.
  1963.  
  1964.        + Between parts of the network.
  1965.  
  1966.        + Between the receiving modem and the receiving program.  This can
  1967.          happen at high transmission speeds when the receiver has specified a
  1968.          large I/O buffer size with the B numeric parameter.
  1969.  
  1970.          Excessive interrupt latency from extended memory ramdisks or disk
  1971.          caches, and poorly written hard disk drivers also wreak havoc on
  1972.          streaming protocols but do not affect start-stop protocols (XMODEM,
  1973.          etc.).  Problems with extended memory disk caches may cause errors
  1974.          at regular intervals; check the receiver's error messages.
  1975.  
  1976.          To work around these problems, give the "handshake slow" command to
  1977.          the receiver.
  1978.  
  1979.      11.2  Subpacket too Long
  1980.  
  1981.      This error may be caused by flow control problems at the sender (see
  1982.      above).
  1983.  
  1984.      11.3  Bad CRC
  1985.  
  1986.      This error may be caused by flow control problems at the sender (see
  1987.      above).
  1988.  
  1989.      Byte NNNN retry M: <error message> These messages appear when the
  1990.      protocol has detected an error and is attempting to retransmit the
  1991.      garbled data.  These are normal messages.
  1992.  
  1993.  
  1994.      11.4  Serial Input Error: Line Status Register xx
  1995.  
  1996.      Serial Input Error: Line Status Register HH indicates a hardware
  1997.      problem, slow device driver, TSR program, or other software is disabling
  1998.      interrupts too long for the program to accept incoming data, and some
  1999.      characters are lost.  A slow response to folow control also triggers
  2000.      this message.
  2001.  
  2002.      The value of the line status register is displayed in HEX.  The
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.      Chapter 11 Pg 32      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2009.  
  2010.  
  2011.      following error conditions are OR'ed into the Line Status Register.
  2012.  
  2013.  
  2014.      01   The Interrupt level circular buffer has been overrun.  The remote
  2015.           did not respond to DSZ's XOFF or hardware flow control, and
  2016.           continued to send characters after being told not to.  This problem
  2017.           is alleviated by correct modem flow control configuration.
  2018.  
  2019.  
  2020.      02   An 02 value for the LSR indicates Data Overrun.  "Data Overrun"
  2021.           means the computer was not able to respond to an incoming character
  2022.           from the UART (modem) in time to make room for the next incoming
  2023.           character.  Data Overruns are caused by poorly designed software
  2024.           (or ROM BIOS "firmware") locking out interrupts for excessive
  2025.           periods.  These lockouts prevent the communications program from
  2026.           responding to the incoming characters quickly enough.
  2027.  
  2028.           To correct Data Overruns, you must correct the offending
  2029.           condition(s) to allow the communications program to operate
  2030.           properly.
  2031.  
  2032.           Common causes of excessively long interrupt lockouts ("critical
  2033.           code regions") are disk drivers (BIOS), window managers, disk
  2034.           caches, TSR programs, and EGA/VGA board auto-select.
  2035.  
  2036.           Slowing the CPU to allow games and other time dependent programs to
  2037.           be used can generate excessive interrupt latency.
  2038.  
  2039.           Some BIOS programs are written without regard to their effect on
  2040.           high speed communications.  Better versions of the offending BIOS
  2041.           programs may be made available if enough users complain about poor
  2042.           performance.
  2043.  
  2044.           Interrupt latency caused by EGA/VGA board auto-select can be often
  2045.           corrected by disabling the board's Auto-Select.
  2046.  
  2047.           Poorly written disk caches and disk drivers cause interrupt latency
  2048.           that affects streaming protocols (ZMODEM) but not start-stop
  2049.           protocols such as XMODEM, YMODEM, JMODEM, Lynx, etc.  The handshake
  2050.           slow command can be used to stop reception during disk transfers.
  2051.  
  2052.           Other chapters in this document give suggestions for working around
  2053.           excessive interrupt latency by using the NS16550AN UART chip.
  2054.           Please refer to the "Brain Damaged UARTS" subchapter.
  2055.  
  2056.           Please try all the suggestions mentioned here before contacting
  2057.           Omen Technology about data overruns.
  2058.  
  2059.  
  2060.      08   Framing Error generally caused by line noise or an incorrect
  2061.           transmission speed ("baud rate") or format (number of bits).  Also
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.      Chapter 11 Pg 33      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2068.  
  2069.  
  2070.           caused by some cheap internal modems.  Most protocols require 8
  2071.           bits no parity (-8n) for proper operation.  This is set
  2072.           automatically by Omen Technology programs, but other programs may
  2073.           not be so smart.
  2074.  
  2075.  
  2076.      10   Break Interrupt generally caused by line noise or an incorrect
  2077.           transmission speed ("baud rate") or format (number of bits).  Also
  2078.           caused by some cheap internal modems.
  2079.  
  2080.  
  2081.      18   Framing Error and Break Interrupt (see above) in combination.
  2082.  
  2083.           This error may also be caused by defective 8250 UART chips.
  2084.           Certain internal modem cards have slow 8250 chips that do not
  2085.           operate properly with computers faster than 4.77 mHz.  Replacing
  2086.           the 8250 with a NS16550AN is recommended.
  2087.  
  2088.      Please refer to the In Case of Difficulty chapter of this document for
  2089.      solutions.
  2090.  
  2091.      Less commonly encountered DSZ error messages are explained in the Pro-
  2092.      YAM manual.
  2093.  
  2094.  
  2095.      11.5  No Carrier Detect
  2096.  
  2097.      If you see a No Carrier Detect message, and you haven't lost the
  2098.      connection, you should fix your modem cable or modem settings to allow
  2099.      proper operation of the Carrier Detect signal (CD).
  2100.  
  2101.      A poorer alternative is to give the d command:  dsz port 1 speed 2400 d
  2102.      t
  2103.  
  2104.  
  2105.      11.6  Port %d (%X) defective
  2106.  
  2107.      When DSZ selects a serial port, it performs a quick hardware check to
  2108.      verify the presence and minimal functionality of the 8250 family UART.
  2109.      This message usually means a nonexistent port has been selected.
  2110.  
  2111.      Reports have been received of functional but nonstandard UART chips
  2112.      triggering this message.
  2113.  
  2114.  
  2115.      11.7  COMMAND NOT FOUND
  2116.  
  2117.      If you see this message, make sure DSZ is in the DOS PATH.  Sometimes
  2118.      this error is caused by having too many environment variable strings.
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.      Chapter 11 Pg 34      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2127.  
  2128.  
  2129.      11.8  Out of Environment
  2130.  
  2131.      means there is not enough room in the program environment to accept more
  2132.      data.
  2133.  
  2134.      DOS prints this message when it cannot allocate more memory to
  2135.      accommodate a "set" command, such as "set dirrx=c:/downloads/".
  2136.  
  2137.      Try moving the "set" commands to the batch file that calls your comms
  2138.      program, or to your AUTOEXEC.BAT file.
  2139.  
  2140.      To increase environment, use the /E switch. The default is 160 bytes.
  2141.  
  2142.      An example for your CONFIG.SIS file: SHELL=C:COMMAND.COM/E:256
  2143.  
  2144.      NOTE: Large environments may cause DSZ.COM to lockup.  This is less of a
  2145.      problem with DSZ.EXE.
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.      Chapter 12 Pg 35      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2186.  
  2187.  
  2188.      12.  SLOW TRANSFERS
  2189.  
  2190.      Some users report slower than expected file transfers even when few or
  2191.      no errors are reported.  Some possible causes are:
  2192.  
  2193.      If "handshake slow" is used, throughput may suffer.  Try one of the
  2194.      other solutions to the "Line Status Register = 02" errors discussed
  2195.      above.  When using "handshake slow" it may be possible to increase the
  2196.      modem's interface speed to 19200 bps or faster.
  2197.  
  2198.      Bad phone lines will silently slow MNP modems, sometimes without any
  2199.      error indications.  If the modems disconnect fairly often you should
  2200.      suspect marginal phone line conditions that are being hidden by MNP
  2201.      error correction.
  2202.  
  2203.      One of the programs may have set a parameter or option that acts to slow
  2204.      the transfer under certain conditions.
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.      Chapter 13 Pg 36      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2245.  
  2246.  
  2247.      13.  IN CASE OF DIFFICULTY
  2248.  
  2249.      13.1  LOCKUPS
  2250.  
  2251.      13.1.1  Insufficient Memory
  2252.      DSZ complains when it detects insufficient memory to operate.  When
  2253.      calling DSZ from another program, there may be ALMOST enough memory for
  2254.      proper operation, but DSZ locks up during a transfer or the calling
  2255.      program freezes after DSZ displays the "DSZ Finished" message.
  2256.  
  2257.      Sometimes there is a message about insufficient memory, sometimes just a
  2258.      lockup and no message.  To verify this problem, call CHKDSK from within
  2259.      your comms program (not from DOS!) by defining it as an external
  2260.      protocol.  If you use an interface program (Hotkeyz, Prodoor, etc.), you
  2261.      must call CHKDSK from that program, as those programs also reduce the
  2262.      memory available to DSZ.
  2263.  
  2264.      CHKDSK should report at least 64k free memory.  If less memory is
  2265.      reported, reduce the size of the COMMS program's capture buffer, or
  2266.      reboot the system with fewer/smaller device drivers and TSR programs.
  2267.      Calling DSZ directly from the comms program instead of from an interface
  2268.      also saves memory.
  2269.  
  2270.  
  2271.      13.1.2  Environment TOO BIG
  2272.      A large environment may cause DSZ.COM to lockup.  The size of the
  2273.      environment (the amount of text you get when you give the DOS "set"
  2274.      command) is subtracted from the data space available to 8086 C programs.
  2275.      This can be a problem with DSZ.COM, whose 8086 tiny model limits code,
  2276.      data, stack, and environment to 64 kb TOTAL.  Use DSZ.EXE (compiled with
  2277.      8086 small model) to alleviate this problem.
  2278.  
  2279.  
  2280.      13.1.3  Bad COM Port Configuration
  2281.      DSZ is fastidious about which interrupt vectors it takes over.  Unlike
  2282.      some programs, DSZ uses only the correct interrupt vector for its
  2283.      interrupt service routine.  (This allows multitasking.)
  2284.  
  2285.      DSZ obtains and releases this vector with standard DOS function calls.
  2286.      This allows multi line operation under DESQview and other multitasking
  2287.      systems.
  2288.  
  2289.      Incorrectly configured serial ports that work with programs that pig out
  2290.      both IRQ3 and IRQ4 will lock up with DSZ.  If DSZ locks up the machine
  2291.      as soon as it tries to send or receive data, this is usually the fault.
  2292.      Make sure the comm port is strapped correctly; COM1 uses IRQ4, COM2 uses
  2293.      IRQ3.  DSZ will lock up if the comm port is not properly set up.
  2294.  
  2295.      In addition, DSZ will not work properly if two devices are connected to
  2296.      the same IRQ line, even when some other programs (that don't use
  2297.      interrupts as intensively) do work normally on the same machine.
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.      Chapter 13 Pg 37      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2304.  
  2305.  
  2306.      COM3 and above are not widely standardized.  If you have problems with
  2307.      COM3, chances are your "COM3" is non standard.
  2308.  
  2309.  
  2310.      13.1.4  LAN Manager Conflicts
  2311.      Some Local Area Network (LAN) managers take over comm ports using code
  2312.      that interferes with DSZ.
  2313.  
  2314.      The following hint is from Tom Louvaris, LANtastic Sales/Support - New
  2315.      York.  Other LAN mamagers may require similar incantations to keep the
  2316.      LAN manager from messing with DSZ's comm port.
  2317.  
  2318.      Problem: When the lan is running, DSZ intermittantly fails.  DSZ starts
  2319.      the transfer by displaying "Ready to send pathname".  The receiving
  2320.      system does noting.  Eventually, DSZ exits with code 1, and no file is
  2321.      sent.
  2322.  
  2323.      To release one or more Com Ports with LANtastic 3.x, enter the
  2324.      following...
  2325.  
  2326.              Net Queue Halt \Sever-name Comn
  2327.  
  2328.  
  2329.      Note: You must be logged on to "Server-name" with Queue priveleges to
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.      Chapter 13 Pg 38      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2363.  
  2364.  
  2365.      enable the operation of this command.
  2366.  
  2367.      13.2  Incorrect Batch Files
  2368.  
  2369.      Incorrect batch files are the number one source of problems using DSZ
  2370.      for uploads and downloads.  Bulletin board programs with convoluted
  2371.      batch file mechanisms exacerbate the problem.
  2372.  
  2373.      DSZ's command line echo was added to assist in correcting defective
  2374.      batch files.  You should see a display like:
  2375.  
  2376.      Command line = 'rz '
  2377.      or
  2378.      Command line = 'port 2 speed 9600 sz foo.baz '
  2379.  
  2380.      You may have to add a "pause" command at the end of the batch file to
  2381.      allow DSZ's messages to be seen.  Another possibility is to turn on the
  2382.      printer with ^P before running DSZ, so DSZ's message can be saved on
  2383.      paper.
  2384.  
  2385.      In general, the Command line display should look like one of the
  2386.      examples in this document or those displayed by DSZ itself.  (The
  2387.      Command line display does not include the name of the DSZ program
  2388.      itself.)
  2389.  
  2390.      Try running DSZ by itself, without any batch files or TSR programs,
  2391.      calling it directly from DOS as described above.
  2392.  
  2393.  
  2394.      13.3  Cheap Internal Modems
  2395.  
  2396.      Numerous trouble reports have been received lately caused by cheap
  2397.      internal modems causing errors on ZMODEM transfers but not XMODEM.  A
  2398.      similar problem was experienced in the mid 80's during beta testing of
  2399.      some 2400 bps modems.  Perhaps defective LSI chips left over from those
  2400.      days were cloned or recovered from the trash bin.
  2401.  
  2402.  
  2403.      13.4  Commands Entered in Upper Case
  2404.  
  2405.      Most DSZ commands and options must be entered in lower case (small
  2406.      letters, not big letters).  Where the documentation or help screen
  2407.      indicates "rz", you must use "rz" and not "RZ".
  2408.  
  2409.  
  2410.      13.5  No Carrier Detect
  2411.  
  2412.      If you see a No Carrier Detect message, and you haven't lost the
  2413.      connection, you should fix your modem cable or modem settings to allow
  2414.      proper operation of the Carrier Detect signal (CD).
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.      Chapter 13 Pg 39      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2422.  
  2423.  
  2424.      A poorer alternative is to give the d command:  dsz port 1 speed 2400 d
  2425.      t
  2426.  
  2427.  
  2428.  
  2429.      13.6  PKARC 3.6
  2430.  
  2431.      It has been reported that PK36 grabs some interrupts and doesn't restore
  2432.      them on exit in an attempt to prevent hacks of the program.  Since
  2433.      eliminating that particular version and cleaning up memory, high speed
  2434.      transfers even with 8250 UARTS work properly again.
  2435.  
  2436.      The problem with PK 3.6 appears to be most severe if a BBS operator has
  2437.      doorware, etc that accesses the PK programs from a shell of some sort.
  2438.      This info may be helpful to users who are having otherwise inexplicable
  2439.      file transfer problems.
  2440.  
  2441.      Phil Katz has written me that this problem has been corrected in
  2442.      subsequent versions.
  2443.  
  2444.  
  2445.      13.7  DOS 3.x
  2446.  
  2447.      DOS 3.x systems may need to have a "STACKS = 8,256" line in CONFIG.SYS
  2448.      to prevent antisocial behavior. This is required on the NEC Multispeed,
  2449.      or if certain TSR's are used.
  2450.  
  2451.  
  2452.      13.8  Perstor Controllers
  2453.  
  2454.      Several reports have been received indicating Perstor disk controllers
  2455.      interfere with data communications.  Perstor is reportedly working on a
  2456.      fix.
  2457.  
  2458.  
  2459.      13.9  IBM PS/2 Model 50Z
  2460.  
  2461.      Early samples of this machine have a design error on the motherboard
  2462.      that causes comms programs to lock up the machine.  Replacing the
  2463.      motherboard with a correctly functioning unit from current production
  2464.      corrects the problem.  The part number of the replacement PS2/50 Z
  2465.      motherboard is 35F5928.  (Information provided by John M. Choma
  2466.      73047,3566) U.S. IBM has stonewalled on this issue, but in December 1988
  2467.      agreed to replace the defective motherboards under warranty.
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.      Chapter 13 Pg 40      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2481.  
  2482.  
  2483.      13.10  Brain Damaged UARTS
  2484.  
  2485.      Omen Technology has received reports of problems with buggy 8250 type
  2486.      UART integrated circuits in Leading Edge modem boards, serial port
  2487.      interfaces, and computers.  The defective chip logic affects high
  2488.      performance software.  Replacing the buggy chip with a newer chip (16450
  2489.      or NS16550AN) corrects the problem.
  2490.  
  2491.      The UM82450 chip in the Zoom 2400HC also appears to cause problems.
  2492.      Zoom Telephonics advises that this problem is limited to their old
  2493.      model.  The old model is inentifiable by an external volume control.
  2494.  
  2495.      The NS16550AN is a pin compatible plug in replacement for 8250 and 16450
  2496.      serial chips.  Omen Technology software enables the FIFO buffer in the
  2497.      NS16550AN to prevents loss of data from poorly written device drivers,
  2498.      TSR programs, etc.
  2499.  
  2500.      The NS16550AN has better electrical characteristics than the older UART
  2501.      chips.  386 and fast 286 machines should use the NS16550AN for best
  2502.      results.  Omen Technology software has been written to allow time for
  2503.      the older UART chips to operate. However, there is a limit to how much
  2504.      the software can rearrange chip accesses without resorting to
  2505.      performance robbing wait loops.  Some other software is not as forgiving
  2506.      of slow chips.
  2507.  
  2508.      Be sure to ask for the NS16550AN.  It is VITAL to get the National
  2509.      Semiconductor "AFN" or "AN" chip.  Other vendors' chips won't do.
  2510.      Current Western Digital WD16C550 chips do not function properly at low
  2511.      speeds.  As of this writing, the National NS16550AN and NS16550FAN are
  2512.      the only plug compatible chips that are known to work.
  2513.  
  2514.      The Hayes ESP board comes with two serial ports with NS16550A devices.
  2515.      The ESP definitions for COM3 and COM4 agree with the industry standard
  2516.      definitions used by Omen Technology.
  2517.  
  2518.      The following information comes from a number of people:
  2519.  
  2520.      "I have located a small dealer in New York who has the cards with or
  2521.      without the 16550.  I believe the price is around $50.00.  The company
  2522.      is RJK Consulting and the number is 718-968-9167. The gentleman to speak
  2523.      to is a Mr. RJ Kulman. ...  I got this information off the "Interlink"
  2524.      BBS system." Fm: Nick Braak [TRICON] 75156,1254
  2525.  
  2526.      Fry's - 415-770-FRYS.  This is a Silicon Valley electronic department
  2527.      store.
  2528.  
  2529.      Jameco Electronics at 415-592-8097 sells National NS16550AN chips mail
  2530.      order (credit card) in small quantities.  Unfortunately, we have
  2531.      received a number of reports that their serial i/o card is now supplied
  2532.      with the infamous WD16C550 soldered in, even when ordered with specific
  2533.      instructions to include 16550AN chips.
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.      Chapter 13 Pg 41      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2540.  
  2541.  
  2542.      Microprocessors Unlimited, 24000 South Peoria, Beggs, OK. (918) 267-
  2543.      4961. The price for the chip is $13.50 plus shipping costs. No minimun
  2544.      purchase is required.
  2545.  
  2546.      Consolidated Computers 4 Shoppers Lane Suite 121 Turnersville, NJ  08012
  2547.      (609)751-9595(voice) (609)751-3843(bbs) (609)751-3840(fax)
  2548.  
  2549.      Arrow Electronics at 800-932-7769 (516-467-1000).
  2550.  
  2551.      Willies Computer Software Company: 800/835-4832.
  2552.  
  2553.      N.B.: Current Western Digital WD16C550 chips do not function properly at
  2554.      low speeds.  This has been confirmed with samples received directly from
  2555.      Western Digital.  WD is aware of this problem, but has not informed us
  2556.      of a corrected chip.
  2557.  
  2558.  
  2559.      13.10.1  Everex Internal Modems
  2560.      Numerous reports have been received concerning difficulties with Everex
  2561.      modem cards.  Some of these cards contain buggy 8250 chips which are not
  2562.      up to the demands of full duplex streaming protocols such as ZMODEM.
  2563.      Replacing the buggy 8250 chip with a 16450 (or better yet NS16550AN)
  2564.      chip corrects these problems.
  2565.  
  2566.  
  2567.      13.11  Weird Iron
  2568.  
  2569.      A few machines, some with V20 CPUs, don't like DSZ.COM.  We have not
  2570.      been able to repeat this; TeleGodzilla (using a V20) runs DSZ.COM
  2571.      without a hitch.  Switching to DSZ.EXE has cleared up the problems on
  2572.      other machines.
  2573.  
  2574.  
  2575.      13.12  Will the real YMODEM please stand up?
  2576.  
  2577.      Some XMODEM programs claiming to support YMODEM neither send nor accept
  2578.      the YMODEM pathname block.  1024 byte XMODEM is XMODEM-1k, not the
  2579.      YMODEM defined by Ward Christensen in 1985 when he invented the term
  2580.      YMODEM.  1987 and later versions of YMODEM.DOC remind the reader of the
  2581.      official YMODEM definition, which has not changed since YMODEM's coinage
  2582.      in 1985.
  2583.  
  2584.  
  2585.      13.13  286 and 386 Extended Memory
  2586.  
  2587.      Virtual memory disk caches and ramdisks using 80286 or 80386 extended
  2588.      memory require a kludge hardware reset of the CPU chip to return to the
  2589.      normal "real mode" after accessing extended memory.  This interference
  2590.      to the interrupt response time causes lost characters on comm ports, and
  2591.      may be minimized by specifying shorter memory transfers.
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.      Chapter 13 Pg 42      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2599.  
  2600.  
  2601.      Switching to a National NS16550AN or NS16550AFN UART chip helps
  2602.      tremendously, allowing transfers at 115200 bps instead of 9600 bps with
  2603.      a standard 8250.  Please refer to the subchapter on "Brain Damaged
  2604.      UARTs".  The DSZ "handshake slow" command may also help.
  2605.  
  2606.  
  2607.      13.14  Disk Caches
  2608.  
  2609.      Cache programs often interfere with ZMODEM transfers.  In one instance,
  2610.      replacing Microsoft's SMARTDRV.SYS with Multisoft's SUPERPCK.EXE helped.
  2611.  
  2612.      Some cache programs can be turned on and off; try turning it off when
  2613.      running DSZ.
  2614.  
  2615.      Switching to a National NS16550AN or NS16550AFN UART chip helps
  2616.      tremendously, allowing transfers at 115200 bps instead of 9600 bps with
  2617.      a standard 8250.  Please refer to the subchapter on "Brain Damaged
  2618.      UARTs".  The DSZ "handshake slow" command may also help.
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.      Chapter 14 Pg 43      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2658.  
  2659.  
  2660.      14.  ASSOCIATED DOCUMENTS
  2661.  
  2662.      Consult the Professional-YAM, PowerCom, or ZCOMM manual chapter "OPTIONS
  2663.      FOR FILE TRANSFERS" for descriptions of the file transfer options.  The
  2664.      "FILE TRANSFER BASICS" chapter explains the relative merits of XMODEM,
  2665.      YMODEM, ZMODEM, and other protocols and gives tips on their use.  The
  2666.      "MAIN COMMANDS" chapter describes the rb, rx, rc, rz, sb, and sz
  2667.      commands.  The "MODEM INTERFACING" and "FLOW CONTROL" chapters contain
  2668.      important information on the use of buffered modems with DSZ.
  2669.  
  2670.      Information on the ZMODEM Inter Application File Transfer Protocol is
  2671.      available in Omen Technology's "ZMODEM DEVELOPER's COLLECTION" ($89.00).
  2672.  
  2673.      Unix, Xenix and VMS C Source code for XMODEM, YMODEM, and ZMODEM
  2674.      transfers to/from Omen Technology Products is included in RZSZ.ZOO.[1]
  2675.      This file includes a Pro-YAM/ZCOMM script to upload a bootstrap file to
  2676.      a Unix system, force its compilation, and (if the compilation is
  2677.      successful) upload the rz/sz source files.
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.      __________
  2708.  
  2709.       1. Technical support for rzsz is available on a paid consulting basis.
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.      Chapter 15 Pg 44      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2717.  
  2718.  
  2719.      15.  FILES
  2720.  
  2721.      DSZ.COM, DSZ.DOC, 2A-PIF.DVP, 2S-PIF.DVP, 2T-PIF.DVP, BBS_REG.TXT,
  2722.      DS.BAT, FIX.BAT, MAILER, ZMODEMAD.BAT, ZMODEMD.BAT, ZMODEMDR.BAT, and
  2723.      ZMODEMU.BAT constitute Omen Technology's DSZ.ZIP.  These same files are
  2724.      in DSZ.ZOO on the distribution diskette mailed to registered users.[1]
  2725.  
  2726.      2S-PIF.DVP, 2A-PIF.DVP, DS.BAT, and 2T-PIF.DVP are used with Quarterdeck
  2727.      Office Systems' DESQview multitasking executive for background
  2728.      operation.  Their use is described in a previous chapter of this
  2729.      document.
  2730.  
  2731.      ZCOMMDOC.ZIP (manual), ZCOMMEXE.ZIP (programs), ZCOMMHLP.ZIP (help
  2732.      processor and database), make up the ZCOMM communications tools
  2733.      shareware distribution.  The ZCOMM files are available on finer bulletin
  2734.      boards.
  2735.  
  2736.      RZSZ.ZOO contains ZMODEM "C" source code for COMPLETE VAX VMS and
  2737.      Unix/Xenix programs licensed for use transferring files to/from licensed
  2738.      Omen Technology products.[2]
  2739.  
  2740.      DSZ.EXE compiled with the Xenix to DOS XC may give moderately higher
  2741.      maximum throughput noticeable on slower machines.  Sending from a faster
  2742.      machine to an 8 NHz Exerex 1800 AT with 16550FAN, using "sz -ym D:*.*"
  2743.      where D: contains B17MH.GIF 356542:
  2744.  
  2745.      Program                       BPS       Throughput
  2746.      DSZ.COM                       115200    5485 cps
  2747.      DSZ.EXE                       115200    8696 cps
  2748.  
  2749.      DSZ.COM                       38400     3793 cps
  2750.      DSZ.EXE                       38400     3793 cps
  2751.  
  2752.      As one can see, the speed difference is important only with high speeds
  2753.      and slow computers (19-38k on a 4.77 MHz PC, 115k on a slow AT).
  2754.  
  2755.      DSZ.EXE supports ZMODEM over 7 bit paths (E and P options), and
  2756.      specified control character quoting (-Q<string> option).  The DSZ.EXE
  2757.      requires somewhat more memory than DSZ.COM.  DSZ.EXE does not support
  2758.      file sharing due to brain damage in the Microsoft C library.  The
  2759.  
  2760.  
  2761.      __________
  2762.  
  2763.       1. DSZ.ZOO is supplied to registrants instead of DSZ.ZIP because not
  2764.          all registrants have copies of unarchiving programs.  The
  2765.          registration disk includes a copy of LOOZ, a simple dearchiver for
  2766.          ZOO files.
  2767.  
  2768.       2. Technical support for rzsz is available on a paid consulting basis.
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.      Chapter 15 Pg 45      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2776.  
  2777.  
  2778.      maximum DSZ.EXE I/O buffer size available with the B numeric parameter
  2779.      is 16384.  DSZ.EXE is available in DSZEXE.ZOO.
  2780.  
  2781.      ZCOMM and Pro-YAM also run faster than DSZ.COM.
  2782.  
  2783.      DSZBG.ZOO contains DSZBG.DOC.  Part of the DSZ registration disk, this
  2784.      file provides background information on the ZCOMM/Pro-YAM commands
  2785.      provided in DSZ.  For non-registered users, the same information is
  2786.      available in ZCOMMDOC.ZIP.
  2787.  
  2788.      The ZOO archive format is a machine independent improvement on the PC-
  2789.      DOS specific .ARC format. The ZOO format has been precisely defined, and
  2790.      stable ZOO archivers/dearchivers are available on a wide variety of
  2791.      systems.
  2792.  
  2793.      LOOZ.EXE unpacks .ZOO archives.  LOOZ.DOC describes LOOZ.EXE.  Be
  2794.      certain to type the arguments to LOOZ in lower case, UPPER CASE WILL NOT
  2795.      WORK.
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.      Chapter 16 Pg 46      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2835.  
  2836.  
  2837.      16.  Other Omen Technology Products
  2838.  
  2839.      16.1  Professional-YAM COMMS TOOLS
  2840.  
  2841.      Omen Technology makes Professional-YAM, a comprehensive comms program
  2842.      with unmatched power.  Flavors are available for PC-DOS, Unix, Xenix,
  2843.      and OS/2 Protected mode.  Unix source code is available under license.
  2844.  
  2845.  
  2846.      16.2  ZCOMM: Industrial Strength COMMS Shareware
  2847.  
  2848.      ZCOMM is a full featured shareware version with a $40.00 basic
  2849.      registration.  Registered DSZ users upgrading to ZCOMM get a free
  2850.      binder!
  2851.  
  2852.  
  2853.      16.3  ZMODEM Developer's Collection
  2854.  
  2855.      Omen Technology sells the "ZMODEM Developer's Collection" for $89.00.
  2856.      This diskette includes the most recent public domain versions of
  2857.      YMODEM.DOC, ZMODEM.DOC and the Unix/VMS rz/sz C source code for YMODEM
  2858.      and ZMODEM.  A set of public domain PC-DOS executable programs are
  2859.      included for convenience.  For many developers, this collection affords
  2860.      a significant labor savings in obtaining these materials.
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.      Chapter 17 Pg 47      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2894.  
  2895.  
  2896.      17.  FAIR PLAY
  2897.  
  2898.      Unlike snazzy menu interfaces, reliable high speed transfer protocols
  2899.      take many hours of testing, often over expensive phone connections, to
  2900.      develop.  Two decades of communications experience and protocol testing
  2901.      are distilled in DSZ.
  2902.  
  2903.      DSZ is a user supported program developed and supported by Chuck
  2904.      Forsberg, owner of Omen Technology.  Countless hours of work and
  2905.      expen$ive resources went to develop and support DSZ for the myriad
  2906.      environments users use it in.  The fact that most of the problems people
  2907.      encounter with DSZ are caused by other software, hardware problems,
  2908.      failure to read the supplied documentation, or pirating has not kept
  2909.      users from seeking and getting help, even if it means calling the author
  2910.      in the middle of his sleep.
  2911.  
  2912.      Beyond this, the world of communications is constantly evolving, and it
  2913.      requires a significant ongoing effort to keep DSZ and its documentation
  2914.      up to date with the current state of the art.  Individuals with little
  2915.      knowledge of the dynamic nature of telecommunications (or hidden
  2916.      agendas) have misrepresented the frequency of enhancements to DSZ as a
  2917.      sign that DSZ is "unstable" and unworthy of "serious consideration".  If
  2918.      you think such sniping is fair play, you are more than welcome to use
  2919.      one of the many other protocol programs available, each of which claim
  2920.      to offer speed and reliability comparable to DSZ.
  2921.  
  2922.      Non registered users are welcome to use DSZ for a reasonable evaluation
  2923.      period.  "Reasonable" means "until you've decided whether the program is
  2924.      worth $20.00".  It does not mean "until some competing program gets
  2925.      around to adding ZMODEM or True Ymodem(TM)".  Once you've evaluated DSZ,
  2926.      ethical use of DSZ requires registering the copy.
  2927.  
  2928.      DSZ is not and never has been Public Domain.  Every version of DSZ has
  2929.      included a Copyright Notice and a prohibition against sale or
  2930.      modification.  There is no usage counter or other Trojan Horse in DSZ,
  2931.      but if you use this program, you have a moral and ethical obligation to
  2932.      register it.
  2933.  
  2934.      Paid registration enables t -8g, DIRRX, DSZOPT, OverThruster(TM),
  2935.      YMODEM-g, and other advanced features that are present in DSZ.ARC in
  2936.      encrypted form.  The registration package serializes and decodes all
  2937.      past and future versions of DSZ.COM and DSZ.EXE.  You can get a fully
  2938.      featured upgrade of DSZ simply by downloading a newer version from
  2939.      TeleGodzilla, GEnie (IBM Roundtable), CompuServe, and trusted bulletin
  2940.      boards.
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.      Chapter 17 Pg 48      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  2953.  
  2954.  
  2955.      17.1  Sharing DSZ Files
  2956.  
  2957.      You are welcome to share unmodified copies of DSZ.ARC or DSZ.ZOO with
  2958.      your friends and associates for their evaluation.  This documentation
  2959.      file and the MAILER file must be provided with all copies of DSZ except
  2960.      by prior written permission from Omen Technology Inc.  Because of piracy
  2961.      problems, Omen Technology must INSIST that DSZ be distributed only as
  2962.      part of the DSZ.ARC file EXACTLY as provided by Omen Technology Inc, or
  2963.      in an archive which displays a CRC value for DSZ.COM equal to that shown
  2964.      in the Changes chapter.  If DSZ.ARC is "zipped" or otherwise repacked,
  2965.      no files may be added to or removed from the archive.
  2966.  
  2967.      If you see an improperly packed or otherwise modified DSZ archive or
  2968.      parts thereof in a bulletin board, please ask the board's operator to
  2969.      replace such files with DSZ.ARC exactly as provided by Omen Technology
  2970.      Inc.  Flame them until they behave ethically.
  2971.  
  2972.      No version of DSZ may be sold without the prior written permission of
  2973.      Omen Technology Inc.
  2974.  
  2975.      DSZ is not and never has been Copy Protected.  "DSZ unprotect" files
  2976.      have no function whatsoever except to aid and encourage the theft of
  2977.      Omen Technology's Intellectual Property.
  2978.  
  2979.      Distribution or use of programs or procedures that modify, patch,
  2980.      disassemble, decompile, or otherwise reverse engineer DSZ without the
  2981.      prior written permission by Omen Technology Inc is a bloody theft of
  2982.      intellectual property and services and is a violation of Federal
  2983.      Copyright Law.  The same applies to debug scripts and documentation
  2984.      written for the same purposes.  These perform the same function as
  2985.      pirate satellite and/or cable descramblers, to obtain benefit from
  2986.      encrypted communications without proper payment.  Piracy has been
  2987.      investigated by the FBI and prosecuted under federal statutes.
  2988.      Applicable law provides for damages and recovery of attorney's fees.
  2989.      Omen Technology has received reports of serious problems caused by
  2990.      unauthorized patches to DSZ, and cannot assume liability for the
  2991.      performance of the resultant code.  So far, none of the slime producing
  2992.      such bilge have seen fit to sign their real name and address to their
  2993.      cretinous attempts at ego gratification.
  2994.  
  2995.      Distribution of DSZ in any medium without this documentation file is an
  2996.      unauthorized modification to DSZ that deprives the rightful author of
  2997.      registration revenues.  That is a theft of intellectual property.  Such
  2998.      distribution damages the author by forcing the user and author to waste
  2999.      time and phone bills scrounging for the documentation, and answering
  3000.      questions that are fully covered in the documentation.
  3001.  
  3002.      If any version of DSZ is distributed with any other product, software or
  3003.      hardware, the product documentation must clearly and prominently state
  3004.      that the customer's continued use of DSZ requires registration directly
  3005.      with Omen Technology or its duly authorized agent(s).  When unregistered
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.      Chapter 17 Pg 49      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3012.  
  3013.  
  3014.      copies of DSZ are distributed on disk, a contemporary copy of
  3015.      ZCOMMDOC.ARC should be included on the same disk.
  3016.  
  3017.      Thank you for your support.
  3018.  
  3019.      17.2  REGISTRATION
  3020.  
  3021.      After a short evaluation period, ethical users must register their copy
  3022.      of DSZ with a check for $20.00 in U.S. funds sent to:
  3023.  
  3024.             Omen Technology Inc.
  3025.             P.O. Box 4681
  3026.             Portland, OR 97208
  3027.  
  3028.      The address on your check is sufficient, no need to fill out forms.
  3029.  
  3030.             For VISA/MC Registrations, you can also:
  3031.             Call VOICE: 503-621-3406
  3032.  
  3033.             Or register online: 503-621-3746  300-1200-2400 bps
  3034.             Or FAX the INSTANT MAILER to: 503-621-3735
  3035.  
  3036.      Don't bother scrounging for an envelope, just print the INSTANT MAILER
  3037.      included in this archive!
  3038.  
  3039.      Overseas registrations are sent out International Air Mail.  Users,
  3040.      especially those overseas, may choose to register their copy of DSZ for
  3041.      $25.00 U.S.  by providing their VISA or Mastercard card number with
  3042.      expiration date and their name as it appears on their credit card.
  3043.  
  3044.      Purchase orders for less than $150 must be prepaid.  Omen Technology Inc
  3045.      Federal TAX ID #: 930858776 Oregon TAX ID #: 536565
  3046.       .ne 12
  3047.  
  3048.      "Das Recht zur Benutzung von DSZ in Deutschland, Oesterreich und der
  3049.      Schweiz erwerben Sie durch Bezahlung der Lizenzgebuehr von DM 57,00
  3050.      (incl. Mwst) an RzK
  3051.  
  3052.      Doris Koepke
  3053.      Bitzenstr. 11
  3054.      D-5464 Asbach
  3055.  
  3056.      Tel. 02683-4547, FAX 49 2683 4537, Telex 86 3705 rzk d, CIS
  3057.      [70126,1660]. Sie erhalten dann von dort sowohl die neueste Version, als
  3058.      auch Ihren individuellen Software-Key, mit dem Sie auch kuenftige
  3059.      Shareware-Versionen "aufschliessen", also die in der Shareware Version
  3060.      nicht zugnglichen Programmfunktionen nutzbar machen koennen, per Post.
  3061.      Die Benutzung nicht registrierter Versionen stellt einen Verstoss
  3062.      geltenden Rechts dar und wird strafrechtlich verfolgt."
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.      Chapter 17 Pg 50      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3071.  
  3072.  
  3073.      *************************************************************************
  3074.      The user registration package includes a printed serial number password
  3075.      (SNP) card.  The registration "care package" diskette contains the
  3076.      latest versions of the DSZ programs, additional user documentation, and
  3077.      the installation program which uses your personal SNP to enable advanced
  3078.      features and bypass the opening advertisement.
  3079.  
  3080.      The registration package unlocks the extra value in all past and future
  3081.      versions of DSZ.COM and DSZ.EXE.
  3082.      *************************************************************************
  3083.  
  3084.      The unique serial number on the registration card is registered to the
  3085.      user, and is acceptable proof of registration to corporate auditors.
  3086.  
  3087.      The putsnp program inserts your unique DSZ Serial Number Password (SNP)
  3088.      into you copy of DSZ with the following command:
  3089.             putsnp dsz.com
  3090.      Putsnp accepts your SNP and asks appropriate questions before inserting
  3091.      the SNP to enable the extra value in DSZ.
  3092.  
  3093.      Your disk directory entry for DSZ will show the date and time you
  3094.      serialized your copy of DSZ.  This does not affect the revision date DSZ
  3095.      announces when DSZ is run.
  3096.  
  3097.      Some TSR programs and device deivers interfere with putsnp.  If you have
  3098.      a lockup running putsnp, run it without any device drivers or TSR
  3099.      programs (boot a plain DOS from floppy disk).
  3100.  
  3101.  
  3102.      The only legitimate way to disable the opening advertisement in DSZ is
  3103.      to insert an authorized SNP obtained from Omen Technology into DSZ with
  3104.      the putsnp program.  Any other suppression or modification of the
  3105.      opening screen is an illegal, unethical theft of services.  Omen
  3106.      Technology has received reports of serious problems caused by
  3107.      unauthorized patches to DSZ, and cannot assume liability for the
  3108.      performance of the resultant code.
  3109.  
  3110.      Piracy is stealing.
  3111.  
  3112.  
  3113.      17.3  Files on Registration Disk
  3114.  
  3115.      The following files are currently included on the Registration Disk sent
  3116.      to paid registrants.
  3117.  
  3118.      LOOZ.EXE       Program to unpack .ZOO archives.  Please note that
  3119.                     commands to LOOZ must be given in lower case.  "looz x
  3120.                     dsz" works, "LOOZ X DSZ" fails.  LOOZ.DOC describes
  3121.                     LOOZ.EXE.
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.      Chapter 17 Pg 51      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3130.  
  3131.  
  3132.      DSZEXE.ZOO     Contains DSZ.EXE.
  3133.  
  3134.                     To dearchive with looz: looz x dszexe (Note: x must be
  3135.                     lower case, X won't work!)
  3136.  
  3137.                     Type "looz" without arguments to see the help message.
  3138.  
  3139.  
  3140.      DSZ.ZOO        Contains DSZ.COM, this document, DESQview description
  3141.                     files, and an instant no-effort registration mailer.
  3142.  
  3143.                     To dearchive with looz: looz x dsz (Note: x must be lower
  3144.                     case, X won't work!)
  3145.  
  3146.                     RZSZ.ZOO contains ZMODEM "C" source code for COMPLETE VAX
  3147.                     VMS and Unix/Xenix programs licensed for use transferring
  3148.                     files to/from licensed Omen Technology products.[1]
  3149.  
  3150.                     To dearchive RZSZ with looz: looz x rzsz (Note: x must be
  3151.                     lower case, X won't work!)
  3152.  
  3153.  
  3154.      PUTSNP.EXE     Installs your unique registered serial number to enable
  3155.                     the extra value in DSZ.
  3156.  
  3157.  
  3158.      DSZBG.DOC (in DSZBG.ZOO) Background information for DSZ, consisting of
  3159.                     relevant parts of the ZCOMM User's Manual.
  3160.  
  3161.                     To dearchive with looz: looz x dszbg (Note: x must be
  3162.                     lower case, X won't work!)
  3163.  
  3164.  
  3165.      17.4  Bulletin Board Registration
  3166.  
  3167.      Note to the wise BBS operator: be sure you understand the DSZ restrict
  3168.      command and how to use it.
  3169.  
  3170.      Use and/or copying of DSZ by bulletin board sysops and/or systems is
  3171.      allowed according to the following conditions:
  3172.  
  3173.      I agree to feature the ZCOMM files (ZCOMMEXE.ZIP, ZCOMMDOC.ZIP,
  3174.      ZCOMMHLP.ZIP) for downloading, and to announce the availability and
  3175.      features of ZCOMM in any bulletins, help displays, or other displays
  3176.      that mention communications programs.  It is my responsibility to
  3177.  
  3178.  
  3179.      __________
  3180.  
  3181.       1. Technical support for rzsz is available on a paid consulting basis.
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.      Chapter 17 Pg 52      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3189.  
  3190.  
  3191.      maintain reasonably current versions of the ZCOMM files on the BBS shown
  3192.      above.
  3193.  
  3194.      I understand that I am welcome to use DSZ on my bulletin board(s) from
  3195.      the time I sign and mail this document as long as I abide by the
  3196.      conditions above, including featuring the above mentioned ZCOMM files.
  3197.  
  3198.      I shall distribute DSZ.COM only as part of the DSZ.ZIP EXACTLY as
  3199.      provided by Omen Technology Inc, or "zipped" without any file additions,
  3200.      deletions, or modifications.  If I distribute DSZEXE.ZOO, I shall also
  3201.      maintain DSZ.ZIP in the same directory since DSZEXE.ZOO references files
  3202.      in DSZ.ZIP.
  3203.  
  3204.      If I see a modified DSZ archive or parts thereof in a file or collection
  3205.      of files (e.g., archive) on a bulletin board, I shall replace such files
  3206.      or archive members with the contents of DSZ.ZIP exactly as provided by
  3207.      Omen Technology Inc.  I shall report instances of noncompliance to Omen
  3208.      Technology.
  3209.  
  3210.      I shall not allow any version of dsz to be sold, modified, patched,
  3211.      hacked, disassembled, decompiled, or otherwise reverse engineered
  3212.      without the prior written permission of Omen Technology Inc.
  3213.  
  3214.      I understand that DSZ is not and never has been Copy Protected.  I fully
  3215.      understand that "DSZ unprotect" files have no function whatsoever except
  3216.      to aid and encourage the theft of Omen Technology's Intellectual
  3217.      Property.
  3218.  
  3219.      (For this BBS registration, a multi node bulletin board operating from a
  3220.      single, common file system counts as one machine.)
  3221.  
  3222.      The purpose of bulletin board registrations is to support and promote
  3223.      ZCOMM and Professional-YAM by popularizing the ZMODEM protocol and
  3224.      featuring the ZCOMM shareware files available for downloading.
  3225.  
  3226.      BBS registrations must be submitted on the bbs_reg form with signature
  3227.      and date, and must accompany a new paid DSZ or ZCOMM registration.  The
  3228.      paid registration that must accompany your BBS registration can be one
  3229.      submitted by one of your board's users.  Most boards have many
  3230.      unregistered DSZ users, so getting one of them to register their DSZ
  3231.      should pose no difficulty.  Since the paid registration may be from one
  3232.      of your board's users, you can get your BBS registered for free by
  3233.      getting one of your users to register his/her DSZ at the same time.
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.      Chapter 17 Pg 53      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3248.  
  3249.  
  3250.      18.  CHANGES
  3251.  
  3252.      Be sure to save your serial number/password (SNP) card and the putsnp
  3253.      program you received from Omen to use with future versions of DSZ you
  3254.      may download!
  3255.  
  3256.      The current DSZ version is maintained on GEnie (IBM Roundtable), EXEC-PC
  3257.      BBS, CompuServe (IBMCOM and CONSULT SIGs) as well as TeleGodzilla.
  3258.  
  3259.      DSZ is a popular program which has been the object of virus attacks.
  3260.      Pirated/hacked versions of DSZ have cost users and DSZ's developer
  3261.      thousands of dollars in lost time and other expenses, in addition to
  3262.      injuring of Omen Technology's reputation.
  3263.  
  3264.      Virus and Trojan code hidden in hacked/pirated copies of DSZ and
  3265.      programs claiming to "register DSZ" have caused loss of data.
  3266.  
  3267.      Name             Length                           Date        Time   CRC
  3268.  
  3269.      dsz.com          51756  Crunched   15%     44432  16 Apr 91   0:39a  43ca
  3270.      dsz.exe          62113  Crunched   19%     50776  16 Apr 91   0:37a  0938
  3271.      PKZIP -vt 32 bit CRC: 7F3514EA   51756  dsz.com
  3272.      PKZIP -vt 32 bit CRC: 96D6BDA4   62113  dsz.exe
  3273.  
  3274.      Your copy of DSZ should show this information as provided by
  3275.  
  3276.             arc v dsz
  3277.      or
  3278.            pkxarc -v dsz
  3279.            lharc v dsz
  3280.  
  3281.      ARC, and LHARC use a 16 bit CRC.
  3282.  
  3283.  
  3284.      ZIP uses a 32 bit CRC compatible with  the  Professional-YAM  and  ZCOMM
  3285.      "crc" command.
  3286.            pkzip -vt dsz
  3287.      The following Pro-YAM/ZCOMM command gives the 32 bit CRC for DSZ.COM:
  3288.  
  3289.      EXAMPLE: >>>c: crc dsz.com
  3290.  
  3291.  
  3292.      If your copy shows a different CRC or file length, insist on a
  3293.      legitimate copy and report the source of the bogus/pirated copy to Omen
  3294.      Technology Inc.  Omen Technology has received reports of serious
  3295.      problems caused by unauthorized patches to DSZ, and cannot assume
  3296.      liability for the performance of the resultant code.
  3297.  
  3298.      COM7 and COM8 are changed; see the "port" command above.
  3299.  
  3300.      A problem in the 1/17/89 and 2/2/89 versions corrupts files under
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.      Chapter 18 Pg 54      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3307.  
  3308.  
  3309.      unusual circumstances.  Please delete all instances of the 1/17/89 and
  3310.      2-02-89 version.
  3311.  
  3312.      A reminder: the -Z option is effective only when it is given to the
  3313.      sending program unless both are Omen Technology products revised Jan 22
  3314.      1990 or later.
  3315.  
  3316.      If you use PREFIX= or ONAME= with the "sb" or "sz" commands, these
  3317.      pathnames must be entered in lower case unless the underlying file
  3318.      system supports upper AND lower case.
  3319.  
  3320.      A boundary condition bug in the implementation of the rz/sz -rr option
  3321.      has been corrected.  When using the -rr option, both sending and
  3322.      receiving programs should be a March 8 1990 or later version.
  3323.      Otherwise, files may be needlessly retransmitted.  This problem does not
  3324.      affect the -r option.
  3325.  
  3326.      April 16 1991: Operation of "handshake slow" has been enhanced when
  3327.      receiving with ZMODEM CRC-32 and MobyTurbo(Tm).  Users who had
  3328.      previously found "handshake slow" unable to control "Line Status
  3329.      Register 02" overrun errors should find the new "handshake slow" more
  3330.      effective on ZMODEM CRC-32 and MobyTurbo downloads.
  3331.  
  3332.      DSZ.COM and DSZ.EXE now announce themselves as DSZ.COM and DSZ.EXE.
  3333.      DSZ.DOC has more discussion of differences between .COM and .EXE flavor.
  3334.      See the FILES chapter for expanded discussion of DSZ.COM vs DSZ.EXE.
  3335.  
  3336.      April 4 1991:  DSZ now supports 115200 bps on suitable hardware.
  3337.      DSZ.EXE throughputs of 113000 bps have been achieved with modest
  3338.      trickery.  "Your mileage may vary."
  3339.  
  3340.      The -I option has been added to the sz command.  The -I option causes
  3341.      new versions (Mar 29 1991 or later) of VMS rz to store files with the
  3342.      VMS Variable length (mrs=510) binary format.  Adding this record format
  3343.      should prevent VMS Kermit servers from corrupting file contents.
  3344.  
  3345.      pcAnywhere users: please read the "A" command description carefully!
  3346.  
  3347.      Feb 28 1991:  The instructions for adding DSZ to ProComm Plus have been
  3348.      updated to include PCP version 2.  Datastorm has not licensed ZMODEM-
  3349.      90(Tm despite allegations that DSZ is now "built in" to ProComm Plus
  3350.      version 2.
  3351.  
  3352.      The F command was added to leave the 16550A FIFO enabled on exit.  The
  3353.      speed command now updates the effective baudrate used for time
  3354.      estimates.
  3355.  
  3356.  
  3357.      sz -e is more network friendly.  (If you don't know what sz -e does, you
  3358.      don't want to know - trust me.)
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.  
  3365.      Chapter 18 Pg 55      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3366.  
  3367.  
  3368.      Dec 16 1990:  Code changes to improve operation with the Intel
  3369.      SatisFAXtion(Tm) modem/fax board.
  3370.  
  3371.      Nov 19 1990:  A number of small enhancements.
  3372.  
  3373.      The sz -i and -u options were added.  The -i option is useful sending
  3374.      files to VMS rz version 4.x, forcing VMS Stream_LF record format.  The
  3375.      -u option unlinks (deletes) a file after it is successfully sent with
  3376.      ZMODEM.
  3377.  
  3378.      SlugBait has been fixed.
  3379.  
  3380.      The Y numeric parameter (described above) has been added to allow FIFO
  3381.      hackers to do their thing.
  3382.  
  3383.      June 25 1990: When a ZMODEM block length is forced, the receiving DSZ
  3384.      writes the data to disk before acknowledging the block.  With DSZ.EXE
  3385.      and its maximum 16384 buffer size, you may be able to avoid overrun
  3386.      (Line Status Register 02) problems receiving to slow disk drives by
  3387.      using:
  3388.      dsz pB16384 z pl16384 rz
  3389.  
  3390.      ZMODEM-90(TM) speeds up GEnie ZMODEM downloads; see DSZOPT in Chapter 6.
  3391.  
  3392.      The "sz" command had an undocumented fallback to YMODEM, this has been
  3393.      removed for reliability reasons.
  3394.  
  3395.      The SlugBait (-s) option now causes DSZ to return success (0 exit code)
  3396.      if at least one file is transferred.
  3397.  
  3398.      April 11 1990: Enhancements for more efficient multitasking under
  3399.      DESQview and DESQview 386.  Code which prevented IRQ conflicts between
  3400.      COM1/COM3 and COM2/COM4 has been removed to allow use of COM7 and COM8
  3401.      without interference from DSZ running on COM1 or COM2..
  3402.  
  3403.      ZIP replaces ARC as the standard download distribution format on new
  3404.      files.
  3405.  
  3406.      March 21 1990: DSZ now sends the CANCEL sequence if it runs out of disk
  3407.      space while receiving a file with ZMODEM.
  3408.  
  3409.      DSZ now defaults to "handshake both" if the clear to send signal is high
  3410.      when DSZ selects the comm port regardless of the initial "baud rate".
  3411.  
  3412.      The P parameter can be set to -1 to disable the FIFO on the Western
  3413.      Digital WD16550 chip.  The WD16550 FIFO has been observed to lose
  3414.      characters when transmitting at slow baud rates.  A more elegant
  3415.      software solution to this hardware problem may be discovered in the
  3416.      future.
  3417.  
  3418.      Feb 25 1990: Doco change only. The "R" numeric parameter or the
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.      Chapter 18 Pg 56      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3425.  
  3426.  
  3427.      "restrict" command may be used to force partially received files to be
  3428.      deleted.  These features have been in DSZ for a long time, but never got
  3429.      into DSZ.DOC.
  3430.  
  3431.      Feb 18 1990: DSZPORT now accepts "portx" style arguments in addition to
  3432.      the traditional decimal number.  The -Wn option has been improved.
  3433.  
  3434.      Jan-28-1990: Doco improvements, especially to the "In Case of
  3435.      Difficulty" chapter.  BBS registration clarified for those that bother
  3436.      to read it.  Qmodem batch files fixed.  No change to the DSZ software.
  3437.  
  3438.      Jan-22-1990: ZMODEM-90(TM) extensions:
  3439.  
  3440.      Receiver specified window size: The -Wn option operates similarly to the
  3441.      -wn option.  The -Wn option is specified to the receiver, which sends
  3442.      this information to the sender.  Pro-YAM, ZCOMM and DSZ versions
  3443.      beginning with Jan 22 1990 support this.
  3444.  
  3445.      Specified extra escaped characters: The "zmtxesc" and "zmrxesc" allow
  3446.      extra characters to be escaped when sending (zmtxesc) or receiving
  3447.      (zmrxesc).  Zmtxesc is effective sending to any ZMODEM program.  The sz
  3448.      commands in Omen products after Jan 22 1990 except for DSZ.COM recognize
  3449.      incoming "zmrxesc" requests.  The zmrxesc and zmtxesc string parameters
  3450.      consist of one or more printing characters corresponding to the control
  3451.      characters to be escaped.  To escape NULL:  set zmrxesc "@"
  3452.  
  3453.      Since DSZ does not support string parameters, a -Q<string> option unique
  3454.      to DSZ performs the same function as zmrxesc and zmtxesc.  If the
  3455.      Q<string> option is used in DSZOPT, it must be last.  To escape NULL:
  3456.      dsz sz -Q@ file.ext
  3457.  
  3458.      MobyTurbo(TM):
  3459.  
  3460.      MobyTurbo optimizes throughput on ZIP, ARC, and similar files without
  3461.      sacrificing ZMODEM's famous reliability on noisy lines.  MobyTurbo works
  3462.      with standard modems, error correcting modems with hardware flow
  3463.      control, and over paths that support ZMODEM and do not "eat" or
  3464.      otherwise respond to control characters.  This includes all paths that
  3465.      support YMODEM-g (or would except for line noise).
  3466.  
  3467.      MobyTurbo can be used for downloads over PC Pursuit if software flow
  3468.      control is not turned on.
  3469.  
  3470.      Activate MobyTurbo with the -m option to one or more of: sz command, rz
  3471.      command, or DSZOPT environment variable.
  3472.  
  3473.      ZMODEM over 7 bit paths:  (Not supported in DSZ.COM)
  3474.  
  3475.      A pair of ZMODEM-90 programs with 7-bit support operating over a 7 bit
  3476.      path should detect that fact and switch to one of two 7-bit path
  3477.      compatible encodings.  For testing, this can be forced with a "-E"
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.      Chapter 18 Pg 57      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3484.  
  3485.  
  3486.      option.
  3487.  
  3488.      Default 7-bit mode is RLE compression and 8th bit quoting similar to
  3489.      Kermit but more efficient because not so many control characters are
  3490.      quoted.  Use this default for text files.  Rubout and all control
  3491.      characters can be escaped with the -e option.  Individual control
  3492.      characters can be escaped with "zmtxesc" and "zmrxesc".
  3493.  
  3494.      Pack-7 instead of quoting is activated with the -P option.  (-P has no
  3495.      effect on 8 bit paths.) Pack-7 packs 4 bytes into 5 printing characters.
  3496.      This is more efficient than quoting for files where 25% more 8th bits
  3497.      appear than the number of characters saved by RLE compression.  (This
  3498.      statement applies to GIF, ARC, ZOO, and ZIP files.  It may or may not
  3499.      apply to other binary file formats, depending on the data.) Pack-7 will
  3500.      match or beat standard Kermit on ZIP files, even when Kermit has use of
  3501.      all 8 bits.
  3502.  
  3503.      SUPK412.ZIP 75136 bytes sent at 2400 bps direct connect from an
  3504.      Everec 1800 AT clone 8mHz/0ws to an 18 mHz Intel 386 motherboard.
  3505.  
  3506.      8-Bit line
  3507.      cps     Protocol/command
  3508.      156     MS Kermit 3.00 to MS Kermit 3.00  (defaults)
  3509.      182     MS Kermit 3.00 to MS Kermit 3.00  (windows=2 length=2000)
  3510.      184     MS Kermit 3.00 to Pro-YAM 17.51 (windows=2 length=2000)
  3511.      231     Pro-YAM 17.51 ZMODEM (defaults)
  3512.      237     Pro-YAM 17.51 ZMODEM-90(TM) MobyTurbo(TM) (sz -m)
  3513.  
  3514.      7-Bit line
  3515.      cps     Protocol/command
  3516.      156     MS Kermit 3.00 to MS Kermit 3.00  (windows=4 length=2000)
  3517.      190     Pro-YAM 17.51 ZMODEM-90 PACK-7 (sz -EP)
  3518.  
  3519.      Kermit transfers used 8 bit CRC, ZMODEM used 32 bit CRC.
  3520.  
  3521.  
  3522.      ************************************************************************
  3523.      ************************************************************************
  3524.  
  3525.      WHAT TO LOOK FOR:
  3526.  
  3527.      Performance     difference     with     MobyTurbo,     possible     side
  3528.      effects/incompatibilities.   MobyTurbo  logic  tests  for  software flow
  3529.      control incompatibilities: when does this test fail?
  3530.  
  3531.      Automatic detection of 7-bit paths.  Spurious detection of  7-bit  paths
  3532.      and failure to detect 7-bit paths.  (DSZ.EXE only)
  3533.  
  3534.  
  3535.      12-13-89  The Virus check was removed because of user confusion and slow
  3536.      startup under certain conditions.  Code has been added to prevent and/or
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.      Chapter 18 Pg 58      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3543.  
  3544.  
  3545.      recover from "line status register 18" errors.
  3546.  
  3547.      10-28-89 A T may be appended to DSZOPT or "dsz t  -T"  may  be  used  to
  3548.      force  DSZ  to  exit  after  it has recognized a ZMODEM AutoDownload(TM)
  3549.      request.
  3550.  
  3551.      10-24-89  BBS registered copies (serial  numbers  8000-8999  and  20000-
  3552.      23999) are now fully featured.
  3553.  
  3554.      The BBS registration form has been  modified.   Please  read  this  form
  3555.      carefully  before  applying  a  BBS  serial  number.   Use of BBS serial
  3556.      numbers (4000, 20000 series) acknowledges acceptance of this contract.
  3557.  
  3558.      The IMP/KMD compatibility file length information in the  YMODEM  header
  3559.      generated by the sb command now uses the correct byte ordering.  Changes
  3560.      to the XMODEM/YMODEM sz/sb commands were made  to  accommodate  programs
  3561.      that ise CK or CKL.  (As predicted in 1985, networks sometimes interfere
  3562.      with these sequences.)
  3563.  
  3564.      Files passed over because of creation errors at the  receiving  end  are
  3565.      now  counted  by the "sz" command as errors.  The receiving program must
  3566.      be a 9/89 or later version for this to be effective.
  3567.  
  3568.      The specified directory form of the rz and rb commands has been  enanced
  3569.      to accommodate certain forms of erroneous syntax.
  3570.  
  3571.      6-19-89 A documentation error (concerning DSZPORT) was corrected in  the
  3572.      DOC file.
  3573.  
  3574.      5-25-89  Corrects a protocol negotiation problem encountered when the rz
  3575.      or sz -e option is used.
  3576.  
  3577.      Host programs can now specify an alternate CANCEL sequence (not used for
  3578.      DOS and Unix).
  3579.  
  3580.      The ZMODEM "Slow Send" mode inserts a brief pause after  each  subpacket
  3581.      when  invoked with the -F option, or automatically when the "sz" command
  3582.      detects failing flow control.  The zmodem F numeric  parameter  (default
  3583.      1) sets the pause in tenths of seconds.
  3584.  
  3585.      4-24-89 The -rr option has been improved.  Long file compares  are  done
  3586.      in  two  stages  to  save  time  when  the  first portions do not match.
  3587.      Diagnostic code and undocumented commands have been removed to  decrease
  3588.      the program size.
  3589.  
  3590.      The 4-18 version introduces ZMODEM variable length headers of up  to  16
  3591.      bytes  information  field instead of the previous fixed 4.  Selection of
  3592.      variable length header capability is automatic and downward  compatible.
  3593.      Variable   length   headers   allow   future   extensions   to  ZMODEM's
  3594.      capabilities.
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.      Chapter 18 Pg 59      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3602.  
  3603.  
  3604.      ZMODEM Crash Recovery now understands the  -rr  option  to  compare  the
  3605.      CRC-32   of  the  assumed  common  file  segment  before  continuing  an
  3606.      incomplete file transfer.  The "zmodem R" numeric parameter may  be  set
  3607.      to limit the number of bytes in the files that are compared; the default
  3608.      R value of 0 allows all of the file to be compared, an  R  value  up  to
  3609.      32000  (up  to 2 billion on 32 bit flavors) limits the comparison to the
  3610.      first R bytes of the two files.  The ZMODEM -rr option is  supported  by
  3611.      Omen Tech versions April 18 1989 and later.
  3612.  
  3613.      When ZMODEM Crash Recovery detects incompatible source  and  destination
  3614.      file  contents,  the  destination  file  is now truncated to zero length
  3615.      before proceeding  with  the  transfer.   Crash  Recovery  requires  the
  3616.      destination file to be no longer than the source file.
  3617.  
  3618.      Error reporting on unregistered copies has been enhanced  to  point  the
  3619.      user to solutions described in the relevant chapters in DSZ.DOC.
  3620.  
  3621.      3-18-89 In order to work around a bug in the  new  TCOMM  bbs,  DSZ  now
  3622.      defaults  to  "handshake  on"  if the speed is greater than 2400 and the
  3623.      clear to send signal is high when DSZ selects the comm port.
  3624.  
  3625.      The "o" command has been added to disconnect the modem after a  terminal
  3626.      session:  "dsz  t  o" disconnects the modem when the terminal session is
  3627.      completed.
  3628.  
  3629.      The "P" (capital P) numeric parameter (q.v.) has been added  to  display
  3630.      and control the UART fifo on some clone chips.
  3631.  
  3632.      BBS registrations postmarked after Feb 28 1989 must be accompanied by  a
  3633.      paid  DSZ  registration.  The free program expired Feb 28 1989.  Outside
  3634.      help has been hired to process and verify  applications  received  under
  3635.      that program.
  3636.  
  3637.      2-23-89 The term function now sends BREAK in response to the ALT-B  key.
  3638.      Handling  of  the  Ctrl-Break  vector  has  been  changed so an untimely
  3639.      keyboarded Ctrl-C or Ctrl-Break will not hang DOS.
  3640.  
  3641.      2-15-89  DIRRX is enabled for BBS registrations (8xxx  numbers).   Logic
  3642.      has  been  added  to  simulate  transmit  interrupts  on chips that have
  3643.      problems in this area.  The "A" command does not  require  registration.
  3644.      An  interaction between ONAME= or PREFIX= and the file count display has
  3645.      been removed.  Time/date conversion routines have been enhanced to  deal
  3646.      with  files with missing dates.  The "v" command has been added to allow
  3647.      bbs programs to interrogate DSZ's serial number.
  3648.  
  3649.      2-06-89 A spurious error message at the completion of  YMODEM  downloads
  3650.      with  a  download  directory  specified  on  the  command  line has been
  3651.      eliminated.
  3652.  
  3653.      2-05-89 DSZ now returns a non 0 status unless at least one file has been
  3654.      transferred.    An   inappropriate   pathname/disk  specifier  check  on
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.      Chapter 18 Pg 60      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3661.  
  3662.  
  3663.      specified download directories has been removed.
  3664.  
  3665.      Previous versions:
  3666.  
  3667.      Added the "A" command to prevent pcAnywhere host mode  from  locking  up
  3668.      DSZ.   SlugBait  logic  has  been  simplified, reporting any failed file
  3669.      transfer where any of the last 1K of the file was sent with Q status.
  3670.  
  3671.      Introduced ZMODEM RLE compression with the -Z option.   (registered  DSZ
  3672.      copies  also  accept "Z" in the DSZOPT environment variable.) ZMODEM RLE
  3673.      compression packs runs of the same character in two or  three  character
  3674.      sequences.    Compression  is  useful  for  screen  dumps,  uncompressed
  3675.      workspaces, compiler listings, and other  files  rich  with  strings  of
  3676.      repeated  characters,  but  not  .ARC,  .ZOO and other compressed files.
  3677.      Compression percentages range from -1 per cent  for  already  compressed
  3678.      files  to  more  than  1000  per  cent  (10x  speedup!) for the Personal
  3679.      Computing text file benchmark(!).  When sending to programs that do  not
  3680.      support  ZMODEM compression, the -Z option is ignored.  The -Z option is
  3681.      effective when specified to the sending program only.
  3682.  
  3683.      Good news for tired frog stompers!  The ZMODEM rz/sz  programs  are  now
  3684.      available  in a VMS C flavor.  The VAX/VMS source files are contained in
  3685.      the RZSZ.ARC (RZSZ.ZOO) archive file.
  3686.  
  3687.      "Handshake slow" has been added to disable the RTS signal to  the  modem
  3688.      while writing to disk, even if the interrupt buffer is not chock full of
  3689.      bytes.  This should help systems with  excessive  interrupt  latency  on
  3690.      disk writes.
  3691.  
  3692.      Setting the v (verbose) parameter to  1  or  greater  causes  serialized
  3693.      copies to ring the bell when a transfer is done.
  3694.  
  3695.      DSZ.DOC has been extensively rewritten and  reorganized.   DSZ  supports
  3696.      the  advanced  buffering of the National NS16550AN, NS16550AFN and Intel
  3697.      82510 serial interface devices.   Please  refer  to  the  subchapter  on
  3698.      "Brain Damaged UARTs".
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.  
  3719.      Chapter 19 Pg 61      DSZ Reference Rev Apr-16-91        Typeset 4-16-91
  3720.  
  3721.  
  3722.      19.  ACKNOWLEDGEMENTS
  3723.  
  3724.      32 bit CRC code courtesy Gary S. Brown.
  3725.  
  3726.      ZMODEM-90(TM), MobyTurbo(TM), The High Reliability Software(TM), Demand
  3727.      Upgrade(TM), TurboLearn Script Writer(TM), Cybernetic Data Recovery(TM),
  3728.      ZMODEM AutoDownload(TM), Intelligent Crash Recovery(TM), Error
  3729.      Containment(TM), Full Time Capture(TM), True YMODEM(TM),
  3730.      OverThruster(TM), Password Guardian(TM), CryptoScript(TM), and
  3731.      TurboDial(TM) are Omen Technology trademarks.
  3732.  
  3733.      PowerCom was trademarked in 1985 by POLYTRON Corporation, Hillsboro
  3734.      Oregon.
  3735.  
  3736.      True YMODEM(TM) is an Omen Technology Trademark signifying YMODEM
  3737.      protocol support that meets the full YMODEM specification.
  3738.  
  3739.      DSZ and this documentation are Copyright 1990 by Omen Technology Inc,
  3740.      all rights reserved.  DSZ is not and never has been Public Domain.
  3741.      Every version of DSZ has included a Copyright Notice and a prohibition
  3742.      against sale or modification.  This prohibition applies to any theft of
  3743.      the intellectual property and trade secrets contained in DSZ by
  3744.      decompilation, disassembly, or any other form of reverse engineering
  3745.      including but not limited to profiling, tracing, data analysis, or
  3746.      monitoring the operation of DSZ.
  3747.  
  3748.      Omen Technology copyright applies to its expression of the encoding and
  3749.      compression ideas expressed as code and byte streams used in the
  3750.      ZMODEM-90 enhancements.
  3751.  
  3752.      DSZ is not and never has been Copy Protected.  "DSZ unprotect" files
  3753.      have no function whatsoever except to aid and encourage the theft of
  3754.      Omen Technology's Intellectual Property.
  3755.  
  3756.                            Omen Technology Incorporated
  3757.                           The High Reliability Software
  3758.  
  3759.                        17505-V Northwest Sauvie Island Road
  3760.                               Portland Oregon 97231
  3761.                     Modem: 503-621-3746 Speed 1200,2400,19200
  3762.                                 FAX: 503-621-3735
  3763.                          CompuServe:70007,2304  GEnie:CAF
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.